VideoPortRegisterBugcheckCallback-Funktion (video.h)

Die VideoPortRegisterBugcheckCallback--Funktion ermöglicht es einem Video-Miniporttreiber, sich für einen Rückruf zu registrieren, der aufgerufen wird, wenn eine angegebene Fehlerüberprüfung auftritt.

Syntax

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortRegisterBugcheckCallback(
  [in] IN PVOID                    HwDeviceExtension,
  [in] IN ULONG                    BugcheckCode,
  [in] IN PVIDEO_BUGCHECK_CALLBACK Callback,
  [in] IN ULONG                    BugcheckDataSize
);

Parameter

[in] HwDeviceExtension

Zeigen Sie auf die Geräteerweiterung des Miniporttreibers.

[in] BugcheckCode

Gibt den Fehlerüberprüfungscode an, für den der Rückruf erfolgen soll. Derzeit kann sich der Miniporttreiber nur für Fehlerüberprüfungscode 0xEA registrieren.

[in] Callback

Zeiger auf die HwVidBugcheckCallback-Funktion des Miniporttreibers. Diese Funktion muss nicht ausgelagert werden und darf nicht auf ausgelagerten Code oder Daten verweisen. Der Miniporttreiber kann diesen Parameter auf NULL- festlegen, um anzugeben, dass der Rückruf der Fehlerüberprüfung aufgehoben werden soll.

[in] BugcheckDataSize

Gibt die Summe der BUGCHECK_DATA_SIZE_RESERVED und die Anzahl der Bytes an, die der Miniporttreiber für die Aufnahme in die Speicherabbilddatei bereitstellt. Der Wert dieses Parameters muss kleiner oder gleich 4000 sein. Der Miniporttreiber kann diesen Parameter auf Null festlegen, um anzugeben, dass der Rückruf der Fehlerüberprüfung aufgehoben werden soll.

Rückgabewert

VideoPortRegisterBugcheckCallback- gibt NO_ERROR zurück, wenn dies erfolgreich ist. Andernfalls wird ein Statuscode zurückgegeben, der die Art des Fehlers angibt.

Bemerkungen

Wenn Sie einen Video-Miniporttreiber entwickeln, der auf Windows XP oder einem früheren NT-Basisbetriebssystem ausgeführt werden soll, können Sie die VideoPortGetProcAddress Rückrufroutine verwenden, um die Adresse der VideoPortRegisterBugcheckCallback--Funktion zu finden. Ausführliche Informationen finden Sie unter Using VideoPortGetProcAddress.

Ein Miniporttreiber kann sich für einen Rückruf registrieren, wenn eine bestimmte Art von Fehlerüberprüfung auftritt. Derzeit können nur Fehlerüberprüfungscode 0xEA eingebunden werden. Wenn die Fehlerüberprüfung auftritt, wird die vom Minidriver bereitgestellte Rückruffunktion aufgerufen, und der Miniporttreiber kann Daten an die Speicherabbilddatei anfügen. Dies ist nützlich für das Sammeln statistischer Daten, wenn das direkte Debuggen nicht möglich ist.

Der Wert des BugcheckDataSize Parameter muss BUGCHECK_DATA_SIZE_RESERVED Bytes größer sein als die vom Miniporttreiber bereitgestellten Daten. Angenommen, der Miniporttreiber stellt DUMP_SIZE Bytes von Daten bereit, die in die Speicherabbilddatei geschrieben werden sollen. Anschließend sollte der Wert von BugcheckDataSize DUMP_SIZE + BUGCHECK_DATA_SIZE_RESERVED sein, und dieser Gesamtwert muss kleiner oder gleich 4000 sein.

Die konstante BUGCHECK_DATA_SIZE_RESERVED (definiert in video.h) ist in Microsoft Windows Server 2003 und späteren Buildumgebungen verfügbar. Verwenden Sie in der Windows XP SP1-Buildumgebung 48 anstelle von BUGCHECK_DATA_SIZE_RESERVED.

Der Miniporttreiber kann die Registrierung eines zuvor registrierten Rückrufs aufheben, indem er diese Funktion aufruft und NULL- für den Parameter Callback angibt, oder null für den parameter DataSize.

Weitere Informationen finden Sie unter Unterstützung des Videoporttreibers für Fehlerüberprüfungsrückrufe.

Anforderungen

Siehe auch

HwVidBugcheckCallback-