IAMErrorLog::LogError-Methode

Hinweis

[Veraltet. Diese API wird möglicherweise aus zukünftigen Releases von Windows.]

Die LogError-Methode protokolliert einen Fehler. Anwendungen müssen diese Methode nicht aufrufen. Sie 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 eine VARIANT-Datei, die zusätzliche Informationen zum Fehler enthält.

Rückgabewert

Gibt den Wert des hresult-Parameters zurück.

Bemerkungen

Geben Sie in dieser Methode nicht den VARIANT-Wert frei, auf den pExtraInfo zeigt. Außerdem wird der VARIANT-Wert 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ückzukehren. Führen Sie innerhalb dieser Methode keine Funktionsaufrufe durch, die möglicherweise die Programmausführung blockieren. Rufen Sie beispielsweise keine Funktionen auf, die Fenstermeldungen senden, Ereignisse blockieren oder die Ausführung anderweitig blockieren. Dies kann dazu führen, dass der Computer nicht mehr reagiert.

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

Hinweis

Die Headerdatei Qedit.h ist nicht mit Direct3D-Headern nach 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.

Requirements (Anforderungen)

Anforderung Wert
Header
Qedit.h
Bibliothek
Strmiids.lib

Weitere Informationen

IAMErrorLog-Schnittstelle

Fehler- und Erfolgscodes