IAMErrorLog::LogError-Methode

[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.]

Hinweis

[Veraltet. Diese API kann aus zukünftigen Versionen von Windows entfernt werden.]

 

Die LogError-Methode protokolliert einen Fehler. Anwendungen müssen diese Methode nicht aufrufen. Es wird intern als Reaktion auf Renderingfehler aufgerufen.

Syntax

HRESULT LogError(
       LONG    Severity,
       BSTR    ErrorString,
       LONG    ErrorCode,
       HRESULT hresult,
  [in] VARIANT *pExtraInfo
);

Parameter

Schweregrad

Reserviert. Darf nicht verwendet werden.

ErrorString

Zeichenfolgenwert, der den Text des Fehlers enthält.

ErrorCode

Fehlercode

Hresult

Der HRESULT-Wert, der vom Methodenaufruf zurückgegeben wurde, der den Fehler verursacht hat.

pExtraInfo [in]

Zeiger auf einen VARIANT-Wert, der zusätzliche Informationen zum Fehler enthält.

Rückgabewert

Gibt den Wert des hresult-Parameters zurück.

Bemerkungen

Geben Sie innerhalb dieser Methode den VARIANT-Wert , auf den pExtraInfo verweist, nicht frei. Außerdem wird variant ungültig, nachdem die Methode zurückgegeben wurde. Versuchen Sie daher nicht, später darauf zu verweisen.

Implementieren Sie diese Methode, um so schnell wie möglich zurückzugeben. Führen Sie keine Funktionsaufrufe von innerhalb dieser Methode aus, die die Programmausführung möglicherweise blockieren. Rufen Sie beispielsweise keine Funktionen auf, die Fensternachrichten senden, Ereignisse blockieren oder die Ausführung anderweitig blockieren könnten. Dies kann dazu führen, dass der Computer nicht mehr reagiert.

Eine Liste der von DES definierten Fehler sowie die Bedeutung und den Datentyp von VARIANT , auf die pExtraInfo verweist, finden Sie unter Renderingfehler.

Hinweis

Die Headerdatei Qedit.h ist nicht mit Direct3D-Headern ab Version 7 kompatibel.

 

Hinweis

Um Qedit.h zu erhalten, laden Sie das Microsoft Windows SDK Update für Windows Vista und .NET Framework 3.0 herunter. Qedit.h ist im Microsoft Windows SDK für Windows 7 und .NET Framework 3.5 Service Pack 1 nicht verfügbar.

 

Anforderungen

Anforderung	Wert
Header	Qedit.h
Bibliothek	Strmiids.lib

Siehe auch

IAMErrorLog-Schnittstelle

Fehler- und Erfolgscodes