PVIDEO_BUGCHECK_CALLBACK Rückruffunktion (video.h)
Mit der HwVidBugcheckCallback--Funktion kann der Miniporttreiber Daten an eine Speicherabbilddatei anfügen, wenn eine Fehlerüberprüfung auftritt.
Syntax
PVIDEO_BUGCHECK_CALLBACK PvideoBugcheckCallback;
void PvideoBugcheckCallback(
[in] IN PVOID HwDeviceExtension,
[in] IN ULONG BugcheckCode,
[in] IN PUCHAR Buffer,
[in] IN ULONG BufferSize
)
{...}
Parameter
[in] HwDeviceExtension
Zeigen Sie auf den Speicherbereich des Miniporttreibers pro Adapter. Weitere Informationen finden Sie unter Geräteerweiterungen.
[in] BugcheckCode
Gibt einen Fehlerüberprüfungscodean.
[in] Buffer
Zeigen Sie auf den Speicherort, an dem der Miniporttreiber die Daten speichern kann, die an die Speicherabbilddatei angefügt werden sollen.
[in] BufferSize
Gibt die Größe des Puffers in Bytes an, auf den der parameter Buffer verweist.
Rückgabewert
Nichts
Bemerkungen
Diese Funktion ist in Windows XP SP1 und höher verfügbar.
Diese Funktion wird aufgerufen, wenn eine Fehlerüberprüfung auftritt. Der Miniporttreiber kann Daten sammeln, die an die Speicherabbilddatei angefügt werden sollen, und diese Daten in den Puffer schreiben. Der Treiber darf nicht mehr als BufferSize Bytes in den Puffer schreiben.
Ein Video-Miniporttreiber registriert die HwVidBugcheckCallback- Funktion, indem die funktion VideoPortRegisterBugcheckCallback aufgerufen wird. Die VideoPortRegisterBugcheckCallback--Funktion macht diesen video miniport driver-bereitgestellten Rückruf an das System verfügbar.
Um die Systemwiederherstellung nach einer Fehlerüberprüfung zu erleichtern, dürfen alle Register, auf die von dieser Funktion zugegriffen wird, nicht die Fähigkeit der Hardware zum Ausweichmodus beeinträchtigen, unabhängig vom Zustand des Geräts. Außerdem muss die Funktion die Steuerung an den Aufrufer zurückgeben.
Da ein System aus mehreren Video-Miniporttreibern bestehen kann, sollten Anbieter den Daten, die diese Funktion an die Speicherabbilddatei anfüge, eine identifizierende Zeichenfolge hinzufügen.
Die Funktion wird bei ausgelöstem IRQL aufgerufen und darf nicht versuchen, auf ausgelagerten Code oder Daten zuzugreifen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | video.h (video.h einschließen) |