AMGetErrorTextA-Funktion (errors.h)
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]
Die FUNKTION AMGetErrorText ruft die Fehlermeldung für einen angegebenen Rückgabecode unter Verwendung der aktuellen Spracheinstellung ab.
Diese Funktion konvertiert HRESULT-Rückgabecodes in Fehlermeldungen. Die Konstante MAX_ERROR_TEXT_LEN gibt die maximale Anzahl von Zeichen in einer Fehlermeldung an.
Syntax
AMOVIEAPI DWORD AMGetErrorTextA(
HRESULT hr,
LPSTR pbuffer,
DWORD MaxLen
);
Parameter
hr
HRESULT-Wert .
pbuffer
Zeiger auf einen Zeichenpuffer, der die Fehlermeldung empfängt.
MaxLen
Anzahl der Zeichen in pBuffer.
Rückgabewert
Gibt die Anzahl der im Puffer zurückgegebenen Zeichen zurück, oder null, wenn ein Fehler aufgetreten ist.
Hinweise
Hinweis
Der errors.h-Header definiert AMGetErrorText als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Windows |
Kopfzeile | errors.h |
Bibliothek | Quartz.lib |