alcGetError: Unterschied zwischen den Versionen
(Die Seite wurde neu angelegt: = alcGetError = == Name == '''alcGetError''' - Liefert den gegenwärtigen Fehlerstatus des aktuellen Kontexts. == Delphi-Spezifikation == function '''alcGetError''...) |
K (Argument ist Zeigertyp) |
||
| Zeile 7: | Zeile 7: | ||
== Delphi-Spezifikation == | == Delphi-Spezifikation == | ||
| − | function '''alcGetError'''(''device'': | + | function '''alcGetError'''(''device'': PALCdevice): TALCenum; |
| Zeile 14: | Zeile 14: | ||
{| border="1" rules="all" | {| border="1" rules="all" | ||
! ''device'' | ! ''device'' | ||
| − | | Gerät, von dem der Fehler abgefragt werden soll | + | | Zeiger auf das Gerät, von dem der Fehler abgefragt werden soll |
|} | |} | ||
| Zeile 47: | Zeile 47: | ||
== Hinweise == | == Hinweise == | ||
Die Funktion gibt einen TALCenum-Wert zurück, welcher den aktuellen Fehlerstatus des jeweiligen Gerätes wiedergibt. Sobald ein ALC-Fehler auftritt, wird der Fehlerstatus gesetzt und wird nicht geändert bis der Fehlerstatus mit '''alcGetError''' abgefragt wird. Wann immer '''alcGetError''' aufgerufen wird, wird der Fehlerstatus gelöscht und der letzte Zustand (d.h. der aktuelle Zustand zum Zeitpunkt des Funktionsaufrufes) wird zurückgegeben. | Die Funktion gibt einen TALCenum-Wert zurück, welcher den aktuellen Fehlerstatus des jeweiligen Gerätes wiedergibt. Sobald ein ALC-Fehler auftritt, wird der Fehlerstatus gesetzt und wird nicht geändert bis der Fehlerstatus mit '''alcGetError''' abgefragt wird. Wann immer '''alcGetError''' aufgerufen wird, wird der Fehlerstatus gelöscht und der letzte Zustand (d.h. der aktuelle Zustand zum Zeitpunkt des Funktionsaufrufes) wird zurückgegeben. | ||
| − | Um den Fehler in einem bestimmten Codeabschnitt zu detektieren, sollte '''alcGetError''' also einmal vor dem entsprechenden Abschnitt aufgerufen werden, um den Fehlerstatus zu löschen | + | Um den Fehler in einem bestimmten Codeabschnitt zu detektieren, sollte '''alcGetError''' also einmal vor dem entsprechenden Abschnitt aufgerufen werden, um den bisherigen Fehlerstatus zu löschen |
Version vom 12. April 2008, 20:26 Uhr
Inhaltsverzeichnis
alcGetError
Name
alcGetError - Liefert den gegenwärtigen Fehlerstatus des aktuellen Kontexts.
Delphi-Spezifikation
function alcGetError(device: PALCdevice): TALCenum;
Parameter
| device | Zeiger auf das Gerät, von dem der Fehler abgefragt werden soll |
|---|
Beschreibung
Die Funktion gibt den Fehlerstatus des aktuellen Kontexts zurück und löscht diesen dann.
Rückgabewerte, anhand deren der Fehler näher bestimmt werden kann, können folgende sein:
| ALC_NO_ERROR | Seit dem letzten Aufruf der Funktion (oder, sofern die Funktion noch nicht aufgerufen wurde, seit dem Start von AL) ist kein Fehler aufgetreten. |
|---|---|
| ALC_INVALID_DEVICE | Das Gerätehandle gibt kein gültiges Gerät/Server an. |
| ALC_INVALID_CONTEXT | Der angegebene Kontext ist nicht gültig. |
| ALC_INVALID_ENUM | Eine benutzte symbolische Konstante ist ungültig bzw. nicht anwendbar. |
| ALC_INVALID_VALUE | Ein Wert (z.B. Attribut) ist ungültig oder im entsprechenden Zusammenhang nicht anwendbar. |
| ALC_OUT_OF_MEMORY | Es konnte nicht genügend Speicher allokiert werden, um die Funktion/ Prozedur auszuführen. |
Hinweise
Die Funktion gibt einen TALCenum-Wert zurück, welcher den aktuellen Fehlerstatus des jeweiligen Gerätes wiedergibt. Sobald ein ALC-Fehler auftritt, wird der Fehlerstatus gesetzt und wird nicht geändert bis der Fehlerstatus mit alcGetError abgefragt wird. Wann immer alcGetError aufgerufen wird, wird der Fehlerstatus gelöscht und der letzte Zustand (d.h. der aktuelle Zustand zum Zeitpunkt des Funktionsaufrufes) wird zurückgegeben. Um den Fehler in einem bestimmten Codeabschnitt zu detektieren, sollte alcGetError also einmal vor dem entsprechenden Abschnitt aufgerufen werden, um den bisherigen Fehlerstatus zu löschen
Fehlermeldungen
Diese Funktion generiert keine Fehler.
