struttura VIDEO_REQUEST_PACKET (video.h)

Un puntatore a una struttura VIDEO_REQUEST_PACKET viene passato alla funzione HwVidStartIO del driver miniport dal driver della porta video. Il driver della porta video configura il VRP dal codice IRP (vedere IRP Major Function Codes) inviato in risposta a una chiamata GDI a EngDeviceIoControl. In genere, il driver di visualizzazione corrispondente effettua la chiamata a EngDeviceIoControl quando necessita del supporto dalla coppia di driver porta-miniport video. Il driver della porta video chiama il driver miniport con il VRP per elaborare la richiesta IOCTL_VIDEO_XXX specificata.

Sintassi

typedef struct _VIDEO_REQUEST_PACKET {
  ULONG         IoControlCode;
  PSTATUS_BLOCK StatusBlock;
  PVOID         InputBuffer;
  ULONG         InputBufferLength;
  PVOID         OutputBuffer;
  ULONG         OutputBufferLength;
} VIDEO_REQUEST_PACKET, *PVIDEO_REQUEST_PACKET;

Members

IoControlCode

Specifica un valore IOCTL_VIDEO_XXX passato alla funzione EngDeviceIoControl dal chiamante e inviato al driver della porta video in un codice IRP. Per altre informazioni sul set di IOCTL_VIDEO_XXX definiti dal sistema che devono supportare i driver miniport, vedere Video Miniport Driver I/O Control Codes.For more information about the set of system-defined IOCTL_VIDEO_XXX that miniport drivers must support, see Video Miniport Driver I/O Control Codes.

StatusBlock

Puntatore a una struttura STATUS_BLOCK in VRP. StatusBlock viene compilato dal driver miniport con informazioni di restituzione al completamento di ogni VRP.

InputBuffer

Puntatore a un buffer di input che contiene informazioni passate dal chiamante. La struttura per i dati dipende dal valore di IoControlCode. Questo membro punta effettivamente allo stesso buffer indicato da OutputBuffer.

InputBufferLength

Specifica le dimensioni in byte del buffer di input.

OutputBuffer

Puntatore a un buffer di output in cui il driver miniport trasferisce i dati da restituire al chiamante. La struttura per i dati dipende dal valore di IoControlCode. Poiché questo membro punta allo stesso buffer di InputBuffer, un driver miniport non deve scrivere l'output in OutputBuffer prima che abbia utilizzato tutti i dati di input da InputBuffer.

OutputBufferLength

Specifica le dimensioni in byte del buffer di output. Un driver miniport non può ingrandire questo buffer. Un driver miniport deve impostare il membro Status di StatusBlock con ERROR_INSUFFICIENT_BUFFER o ERROR_MORE_DATA se l'outputBuffer specificato è troppo piccolo per contenere tutte le informazioni restituite.

Requisiti

Requisito	Valore
Intestazione	video.h (include Video.h)

Vedi anche

HwVidStartIO

STATUS_BLOCK

Codici di controllo I/O del driver miniport video