VideoPortLogError-Funktion (video.h)

Die VideoPortLogError-Funktion protokolliert Fehler im Systemereignisprotokoll, wenn ein Miniporttreiber während E/A-Vorgängen einen Hardwarefehler erkennt.

Syntax

VIDEOPORT_API VOID VideoPortLogError(
  PVOID                 HwDeviceExtension,
  PVIDEO_REQUEST_PACKET Vrp,
  VP_STATUS             ErrorCode,
  ULONG                 UniqueId
);

Parameter

HwDeviceExtension

Zeiger auf die Geräteerweiterung des Miniporttreibers.

Vrp

[optional] Zeiger auf eine [VIDEO_REQUEST_PACKET]-Struktur, die das Video request packet (VRP) beschreibt, wenn eins dem Fehler zugeordnet ist; andernfalls NULL.

ErrorCode

Gibt einen vom Miniporttreiber definierten Fehlercode an, der den Typ des Hardwarefehlers angibt.

UniqueId

Gibt einen eindeutigen Bezeichner für den Fehler an. Dieser Wert unterscheidet den aktuellen Fehler von anderen Fehlern mit demselben ErrorCode. Bei einigen Miniporttreibern identifiziert dies die Codezeile, in der der Fehler erkannt wurde. für andere ist dies ein wert, der von der Hardware zurückgegeben wird.

Rückgabewert

Keine

Bemerkungen

Miniport-Treiber sollten VideoPortLogError aufrufen, um den Benutzer zu benachrichtigen, wenn während des normalen Betriebs ungewöhnliche Hardwarefehler beim Treiber auftreten. Wenn Sie solche Fehler im Systemereignisprotokoll veröffentlichen, wird der Benutzer gewarnt, dass die Grafikkarte möglicherweise fehlschlägt, sodass der Benutzer den Adapter ersetzen (oder neu konfigurieren) kann, bevor ein Hardwarefehler auftritt.

Miniporttreiber sollten jedoch keine Fehler protokollieren, z. B. "Hardware konnte nicht erkannt werden", die häufig während des normalen Betriebs auftreten.

VideoPortLogError kann über die Funktion HwVidInterrupt oder HwVidSynchronizeExecutionCallback eines Miniporttreibers aufgerufen werden.

Anforderungen

Weitere Informationen

VideoDebugPrint