PVIDEO_BUGCHECK_CALLBACK video.h () 的回呼函式
HwVidBugcheckCallback 函式可讓迷你埠驅動程式在錯誤檢查發生時將數據附加至傾印檔案。
語法
PVIDEO_BUGCHECK_CALLBACK PvideoBugcheckCallback;
void PvideoBugcheckCallback(
[in] IN PVOID HwDeviceExtension,
[in] IN ULONG BugcheckCode,
[in] IN PUCHAR Buffer,
[in] IN ULONG BufferSize
)
{...}
參數
[in] HwDeviceExtension
迷你埠驅動程式每個適配卡儲存區域的指標。 如需詳細資訊，請參閱 裝置延伸模組。
[in] BugcheckCode
指定 錯誤檢查碼。
[in] Buffer
迷你埠驅動程式可儲存要附加至傾印檔案之數據的記憶體位置指標。
[in] BufferSize
指定 Buffer 參數所指向之緩衝區的大小，以位元組為單位。
傳回值
無
備註
此函式可在 Windows XP SP1 和更新版本中使用。
當錯誤檢查發生時，會呼叫此函式。 迷你埠驅動程式可以收集要附加至傾印檔案的數據，並將此數據寫入緩衝區。 驅動程式不得將超過 BufferSize 位元組寫入緩衝區。
視訊迷你埠驅動程式會呼叫 VideoPortRegisterBugcheckCallback 函式來註冊 HwVidBugcheckCallback 函式。 VideoPortRegisterBugcheckCallback 函式會將此視訊迷你埠驅動程式提供的回呼公開給系統。
為了在錯誤檢查之後協助系統復原，不論裝置的狀態為何，此函式存取的任何緩存器都不得妨礙硬體傳輸至後援模式的能力。 此外，函式 必須將 控件傳回給其呼叫端。
因為系統可以包含多個視訊迷你埠驅動程式，所以廠商應該將識別字元串新增至此函式附加至傾印檔案的數據。
函式會在引發的 IRQL 呼叫，且不得嘗試存取可分頁的程式代碼或數據。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | 桌面 |
| 標頭 | video.h (包含 Video.h) |