共用方式為


PVIDEO_HW_START_IO回呼函式 (video.h)

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 必須執行下列動作:

  1. 查看 VRPIoControlCode 成員,以判斷顯示驅動程式所要求的作業。
  2. 檢查 VRP InputBufferLength 和/或 OutputBufferLength 表示足以滿足要求的緩衝區。 如果任一個緩衝區太小,迷你埠驅動程序應該會傳回錯誤。
  3. 滿足要求。
  4. VRP 中設定 狀態資訊 成員,並傳回 true
系統視訊埠驅動程式會串行化所有要求。 迷你埠驅動程式不需要執行自己的任何串行化,除非它有 HwVidInterrupt 函式。

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

HwVidStartIO 應設為可分頁。

要求

要求 價值
目標平臺 桌面
標頭 video.h (include Video.h)

另請參閱

VIDEO_REQUEST_PACKET

視訊 Miniport 驅動程式 I/O 控制程式代碼

VideoPortSynchronizeExecution