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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 |
| Zielplattform | Desktop |
| Kopfzeile | video.h (Video.h einschließen) |
| Bibliothek | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | <= DIRQL |