(video.h) PVIDEO_HW_START_IO 回呼函式

HwVidStartIO 會處理指定的 VRP。

語法

PVIDEO_HW_START_IO PvideoHwStartIo;

BOOLEAN PvideoHwStartIo(
  PVOID HwDeviceExtension,
  PVIDEO_REQUEST_PACKET RequestPacket
)
{...}

HwDeviceExtension

迷你埠驅動程式每個適配卡儲存區域的指標。如需詳細資訊，請參閱裝置延伸模組。

RequestPacket

VIDEO_REQUEST_PACKET 結構的指標，其中包含原本傳遞至 EngDeviceIoControl 的所有參數。

HwVidStartIO 必須傳回 TRUE，表示它已完成要求。

每個視訊迷你埠驅動程式都必須具有 HwVidStartIO 函式。

視訊埠驅動程式會呼叫 HwVidStartIO ，以回應來自對應顯示驅動程式的每個 GDI EngDeviceIoControl 要求。呼叫 HwVidStartIO 時，迷你埠驅動程式會擁有輸入視訊要求封包，直到完成要求的作業為止。 HwVidStartIO 必須執行下列動作：

查看 VRP 的 IoControlCode 成員，以判斷顯示驅動程式所要求的作業。
檢查 VRP InputBufferLength 和/或 OutputBufferLength 指出足以滿足要求的緩衝區。如果任一緩衝區太小，迷你埠驅動程序應該會傳回錯誤。
滿足要求。
在 VRP 中設定 [狀態] 和 [資訊] 成員，並傳回 TRUE。

系統視訊埠驅動程式會串行化所有要求。迷你埠驅動程式不需要自行執行任何串行化，除非它具有 HwVidInterrupt 函式。

不過，每個迷你埠驅動程式的 HwVidStartIO 函式都必須完成每個要求的作業，或在 VRP 的 StatusBlock 中設定適當的錯誤，才能傳回控制權。

HwVidStartIO 應該可分頁。

需求	值
目標平台	桌面
標頭	video.h (包含 Video.h)