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) |