PVIDEO_HW_START_IO Rückruffunktion (video.h)

Artikel
02/27/2024

HwVidStartIO verarbeitet den angegebenen VRP.

Syntax

PVIDEO_HW_START_IO PvideoHwStartIo;

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

Parameter

HwDeviceExtension

Zeiger auf den Speicherbereich des Miniporttreibers pro Adapter. Weitere Informationen finden Sie unter Geräteerweiterungen.

RequestPacket

Zeiger auf eine VIDEO_REQUEST_PACKET-Struktur , die alle Parameter enthält, die ursprünglich an EngDeviceIoControl übergeben wurden.

Rückgabewert

HwVidStartIO muss TRUE zurückgeben, was angibt, dass die Anforderung abgeschlossen wurde.

Hinweise

Jeder Video-Miniporttreiber muss über eine HwVidStartIO-Funktion verfügen.

Der Videoporttreiber ruft HwVidStartIO als Reaktion auf jede GDI EngDeviceIoControl-Anforderung auf, die vom entsprechenden Anzeigetreiber stammt. Wenn HwVidStartIO aufgerufen wird, besitzt der Miniporttreiber das Eingabevideoanforderungspaket, bis er den angeforderten Vorgang abgeschlossen hat. HwVidStartIO muss folgendes tun:

Sehen Sie sich das IoControlCode-Element des VRP an, um den vom Anzeigetreiber angeforderten Vorgang zu ermitteln.
Überprüfen Sie, ob vrp InputBufferLength und/oder OutputBufferLength einen Puffer angibt, der groß genug ist, um die Anforderung zu erfüllen. Der Miniporttreiber sollte einen Fehler zurückgeben, wenn einer der Puffer zu klein ist.
Erfüllen Sie die Anforderung.
Legen Sie die Elemente Status und Information im VRP fest, und geben Sie TRUE zurück.

Der Systemvideoporttreiber serialisiert alle Anforderungen. Ein Miniporttreiber muss keine eigene Serialisierung durchführen, es sei denn, er verfügt über eine HwVidInterrupt-Funktion .

Die HwVidStartIO-Funktion jedes Miniporttreibers muss jedoch jeden angeforderten Vorgang abschließen oder einen entsprechenden Fehler im StatusBlock des VRP festlegen, bevor die Steuerung zurückgegeben wird.

HwVidStartIO sollte als ausserstellbar gemacht werden.