PVIDEO_HW_START_IO funzione di callback (video.h)

Articolo
02/26/2024

HwVidStartIO elabora la VRP specificata.

Sintassi

PVIDEO_HW_START_IO PvideoHwStartIo;

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

Parametri

HwDeviceExtension

Puntatore all'area di archiviazione per adattatore del driver miniport. Per altre informazioni, vedere Estensioni del dispositivo.

RequestPacket

Puntatore a una struttura VIDEO_REQUEST_PACKET , che contiene tutti i parametri originariamente passati a EngDeviceIoControl.

Valore restituito

HwVidStartIO deve restituire TRUE, che indica che ha completato la richiesta.

Commenti

Ogni driver miniport video deve avere una funzione HwVidStartIO .

Il driver della porta video chiama HwVidStartIO in risposta a ogni richiesta GDI EngDeviceIoControl , che ha origine nel driver di visualizzazione corrispondente. Quando viene chiamato HwVidStartIO , il driver miniport possiede il pacchetto di richiesta video di input finché non completa l'operazione richiesta. HwVidStartIO deve eseguire le operazioni seguenti:

Esaminare il membro IoControlCode della VRP per determinare l'operazione richiesta dal driver di visualizzazione.
Verificare che l'input VRPBufferLength e/o OutputBufferLength indica un buffer sufficientemente grande per soddisfare la richiesta. Il driver miniport deve restituire un errore se il buffer è troppo piccolo.
Soddisfare la richiesta.
Impostare i membri Stato e Informazioni nella VRP e restituire TRUE.

Il driver della porta video di sistema serializza tutte le richieste. Un driver miniport non deve eseguire alcuna serializzazione del proprio a meno che non abbia una funzione HwVidInterrupt .

Tuttavia, ogni funzione HwVidStartIO del driver miniport deve completare ogni operazione richiesta o impostare un errore appropriato nello StatusBlock del VRP prima di restituire il controllo.

HwVidStartIO deve essere reso paginabile.