alDeleteSources

Aus DGL Wiki
Wechseln zu: Navigation, Suche

alDeleteSources

Name

alDeleteSources - Löscht eines oder mehrere Source-Objekte.

Delphi-Spezifikation

procedure alBefehl(n: TALsizei; sources: PALuint);


Parameter

n Anzahl der zu löschenden Source-Objekte
sources Zeiger auf einen Array von Source-Name, welche die zu löschenden Source-Objekte angeben


Beschreibung

Diese Funktion löscht eines oder mehrere Source-Objekte.


Hinweise

Sofern die gewünschte Anzahl von Source-Objekten nicht gelöscht werden kann, wird ein Fehler generiert, welcher über alGetError bestimmt werden kann. Falls ein Fehler auftritt, wird keines der Source-Objekte gelöscht. Hat der Parameter n den Wert null, so tut diese Prozedur nichts und erzeugt auch keinen Fehler.

Ein Source-Objekt, welches sich gerade im Zustand AL_PLAYING befindet, kann gelöscht werden. Das Source-Objekt wird dazu einfach erst gestoppt und dann gelöscht.



Fehlermeldungen

AL_INVALID_NAME wird generiert, falls mindestens eines der angegebenen Source-Objekte nicht gültig ist oder falls versucht wird, mehr Source-Objekte zu löschen als vorhanden sind.

AL_INVALID_OPERATION wird generiert, wenn kein aktueller Kontext existiert.


Siehe auch

alGenSources, alIsSource

'