alSourceUnqueueBuffers
Inhaltsverzeichnis
alSourceUnqueueBuffers
Name
alSourceUnqueueBuffers - Trennt einen oder mehrere Puffer von einem Source-Objekt.
Delphi-Spezifikation
procedure alSourceUnqueueBuffers(source: TALuint; n: TALsizei; buffers: PALuint);
Parameter
| source | Name des Source-Objektes, von dem die Puffer getrennt werden sollen |
|---|---|
| n | Anzahl der Puffer, die von dem Source-Objekt getrennt werden sollen |
| buffers | Zeiger auf einen Array von Puffernamen (ALuint), welche die vom Source-Objekt zu entfernenden Puffer bestimmt |
Beschreibung
Diese Funktion trennt einen oder mehrere Puffer, die mit einem Source-Objekt verbunden sind, von eben diesem Source-Objekt. Die Anzahl der schon verarbeiteten Puffer kann mit einem Aufruf von alGetSourcei mit dem Parameter AL_BUFFERS_PROCESSED bestimmt werden. So erhält man die maximale Anzahl an Puffern, die mit der Prozedur alSourceUnqueueBuffers von dem Source-Objekt getrennt werden können. Verwendet man alGetSourcei stattdessen den Parameter AL_BUFFERS_QUEUED, so erhält man die Anzahl der insgesamt an dieses Source-Objekt angehängten Puffer.
Hinweise
Die Puffer werden nur vom Source-Objekt getrennt, falls alle n Puffer von diesem Objekt getrennt werden können.
Fehlermeldungen
AL_INVALID_VALUE wird generiert, falls mindestens ein Puffer nicht getrennt werden kann, weil er noch nicht verarbeitet wurde.
AL_INVALID_NAME wird generiert, sofern source kein gültiges Source-Objekt repräsentiert. (Siehe dazu auch alIsSource.)
AL_INVALID_OPERATION wird generiert, wenn es keinen aktuellen Kontext gibt. (Siehe dazu auch alcMakeContextCurrent.)
Zugehörige Wertrückgaben
alGetSourcei mit Token AL_BUFFERS_PROCESSED oder auch AL_BUFFERS_QUEUED
Siehe auch
'
