alSourceUnqueueBuffers

alSourceUnqueueBuffers

alSourceUnqueueBuffers

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

alSourceQueueBuffers

'