AMGetErrorTextA-Funktion (errors.h)
[Das dieser Seite zugeordnete Feature DirectShow-ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngineund Audio/Video Capture in Media Foundationersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code MediaPlayer-, IMFMediaEngine und Audio-/Videoaufnahme in Media Foundation anstelle von DirectShow-verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, um die neuen APIs zu verwenden, falls möglich umgeschrieben werden.]
Die AMGetErrorText--Funktion ruft die Fehlermeldung für einen bestimmten Rückgabecode mithilfe der aktuellen Spracheinstellung ab.
Diese Funktion konvertiert HRESULT- Zurücksenden von Codes 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
Zeigen Sie 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 oder null zurück, wenn ein Fehler aufgetreten ist.
Bemerkungen
Anmerkung
Der Header errors.h 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- | Fenster |
| Header- | errors.h |
| Library | Quarz.lib |