VIDEO_REQUEST_PACKET Struktur (video.h)

Ein Zeiger auf eine VIDEO_REQUEST_PACKET-Struktur wird vom Videoporttreiber an die HwVidStartIO-Funktion des Miniporttreibers übergeben. Der Videoporttreiber richtet den VRP aus dem IRP-Code (siehe IRP-Hauptfunktionscodes) ein, der als Reaktion auf einen GDI-Aufruf von EngDeviceIoControl gesendet wurde. In der Regel ruft der entsprechende Anzeigetreiber EngDeviceIoControl auf, wenn es Unterstützung vom Videoport-Miniport-Treiberpaar benötigt. Der Videoporttreiber ruft den Miniporttreiber mit dem VRP auf, um die angegebene IOCTL_VIDEO_XXX-Anforderung zu verarbeiten.

Syntax

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

Member

IoControlCode

Gibt einen IOCTL_VIDEO_XXX-Wert an, der vom Aufrufer an die EngDeviceIoControl-Funktion übergeben und in einem IRP-Code an den Videoporttreiber gesendet wird. Weitere Informationen zu den systemdefinierten IOCTL_VIDEO_XXX , die Miniporttreiber unterstützen müssen, finden Sie unter E/A-Steuerungscodes für Video-Miniporttreiber.

StatusBlock

Zeiger auf eine STATUS_BLOCK-Struktur im VRP. StatusBlock wird vom Miniporttreiber nach Abschluss jedes VRP mit Rückgabeinformationen ausgefüllt.

InputBuffer

Zeiger auf einen Eingabepuffer, der vom Aufrufer übergebene Informationen enthält. Die Struktur für die Daten hängt vom Wert von IoControlCode ab. Dieses Element verweist tatsächlich auf denselben Puffer, der von OutputBuffer angegeben wird.

InputBufferLength

Gibt die Größe des Eingabepuffers in Bytes an.

OutputBuffer

Zeiger auf einen Ausgabepuffer, in den der Miniporttreiber Daten überträgt, die an den Aufrufer zurückgegeben werden sollen. Die Struktur für die Daten hängt vom Wert von IoControlCode ab. Da dieses Element auf denselben Puffer wie InputBuffer verweist, darf ein Miniporttreiber keine Ausgabe im OutputBuffer schreiben, bevor er alle Eingabedaten aus dem InputBuffer verbraucht hat.

OutputBufferLength

Gibt die Größe des Ausgabepuffers in Bytes an. Ein Miniporttreiber kann diesen Puffer nicht vergrößern. Ein Miniporttreiber sollte das Statuselement des StatusBlock mit ERROR_INSUFFICIENT_BUFFER oder ERROR_MORE_DATA festlegen, wenn der angegebene OutputBuffer zu klein ist, um alle zurückgegebenen Informationen zu enthalten.

Anforderungen

Anforderung	Wert
Header	video.h (einschließen von Video.h)

Weitere Informationen

HwVidStartIO

STATUS_BLOCK

E/A-Steuerungscodes des Video-Miniporttreibers