PVIDEO_HW_START_IO Rückruffunktion (video.h)

Artikel
02/07/2025

HwVidStartIO verarbeitet die angegebene VRP-.

Syntax

PVIDEO_HW_START_IO PvideoHwStartIo;

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

Parameter

HwDeviceExtension

Zeigen Sie 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 sie die Anforderung abgeschlossen hat.

Bemerkungen

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

Der Videoporttreiber ruft HwVidStartIO- als Reaktion auf jede GDI-EngDeviceIoControl Anforderung auf, die aus dem entsprechenden Anzeigetreiber stammt. Wenn HwVidStartIO- aufgerufen wird, besitzt der Miniporttreiber das Eingabevideoanforderungspaket, bis er den angeforderten Vorgang abgeschlossen hat. HwVidStartIO- müssen folgende Aktionen ausführen:

Sehen Sie sich das IoControlCode- Mitglied des VRP- an, um den vom Anzeigetreiber angeforderten Vorgang zu ermitteln.
Überprüfen Sie, ob die 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 ein Puffer zu klein ist.
Erfüllen Sie die Anforderung.
Legen Sie die Status- und Information Mitglieder im VRP- fest und geben Sie TRUE-zurück.

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

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

HwVidStartIO sollte seitenfähig gemacht werden.