PVIDEO_BUGCHECK_CALLBACK Rückruffunktion (video.h)

Die Funktion HwVidBugcheckCallback ermöglicht es dem Miniporttreiber, Daten an eine Speicherabbilddatei anzufügen, wenn eine Fehlerprüfung durchgeführt wird.

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

Zeiger auf den Speicherbereich des Miniporttreibers pro Adapter. Weitere Informationen finden Sie unter Geräteerweiterungen.

[in] BugcheckCode

Gibt einen Fehlerprüfungscode an.

[in] Buffer

Zeiger 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 Buffer-Parameter verweist.

Rückgabewert

Keine

Bemerkungen

Diese Funktion ist in Windows XP SP1 und höher verfügbar.

Diese Funktion wird aufgerufen, wenn eine Fehlerprüfung durchgeführt wird. 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 durch Aufrufen der VideoPortRegisterBugcheckCallback-Funktion . Die VideoPortRegisterBugcheckCallback-Funktion macht diesen vom Video-Miniporttreiber bereitgestellten Rückruf an das System verfügbar.

Um die Systemwiederherstellung nach einer Fehlerüberprüfung zu erleichtern, dürfen Register, auf die von dieser Funktion zugegriffen wird, die Fähigkeit der Hardware, unabhängig vom Zustand des Geräts, in den Fallbackmodus zu übertragen, nicht beeinträchtigen. Außerdem muss die Funktion die Steuerung an ihren Aufrufer zurückgeben.

Da ein System aus mehreren Video-Miniporttreibern bestehen kann, sollten Anbieter den Daten, die von dieser Funktion an die Speicherabbilddatei angefügt werden, eine identifizierende Zeichenfolge hinzufügen.

Die Funktion wird bei ausgelöstem IRQL aufgerufen und darf nicht versuchen, auf ausgelagerten Code oder Daten zuzugreifen.

Anforderungen

Weitere Informationen

VideoPortRegisterBugcheckCallback