AMGetErrorTextA-Funktion (errors.h)

  • Artikel

[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

Siehe auch

Funktionen