PMINIPORT_GET_REGISTRY_ROUTINE Rückruffunktion (video.h)

Artikel
02/07/2025

HwVidQueryNamedValueCallback verarbeitet die angegebenen Daten, die aus der Registrierung abgerufen wurden.

Syntax

PMINIPORT_GET_REGISTRY_ROUTINE PminiportGetRegistryRoutine;

VP_STATUS PminiportGetRegistryRoutine(
  PVOID HwDeviceExtension,
  PVOID Context,
  PWSTR ValueName,
  PVOID ValueData,
  ULONG ValueLength
)
{...}

Parameter

HwDeviceExtension

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

Context

Zeiger auf einen treiberbestimmten Kontext, der als Eingabe für die VideoPortGetRegistryParameters--Funktion angegeben wurde.

ValueName

Zeigen Sie auf eine MIT NULL beendete Unicode-Zeichenfolge, die den Eintrag benennt.

ValueData

Zeiger auf die gepufferten Daten, die ValueNamezugeordnet sind , bereitgestellt von VideoPortGetRegistryParameters.

ValueLength

Gibt die Größe in Byte des Puffers bei ValueData-an.

Rückgabewert

HwVidQueryNamedValueCallback den Status des Vorgangs zurück.

Bemerkungen

HwVidQueryNamedValueCallback ist eine optionale Miniporttreiberfunktion, die in einem Aufruf von VideoPortGetRegistryParametersübergeben wird.

VideoPortGetRegistryParameters aufruft HwVidQueryNamedValueCallback nach dem Sammeln verfügbarer Konfigurationsinformationen über die angegebene ValueName- im Adapter Schlüssel der Registrierung.

HwVidFindAdapter- oder HwVidInitialize- können VideoPortGetRegistryParameters mit einer vom Treiber bereitgestellten HwVidQueryNamedValueCallback--Funktion aufrufen, Zeiger auf die Geräteerweiterung und alle vom Treiber bereitgestellten Kontextdaten (dies kann der VIDEO_PORT_CONFIG_INFO Puffer sein) und einen Zeiger auf eine Unicode-Zeichenfolge, die den Wert benennt, der aus der Registrierung abgerufen werden soll.

HwVidFindAdapter oder HwVidInitialize kann VideoPortGetRegistryParameters's IsFileNameParameter Argument auf TRUE festlegen, wenn die vom Treiber bereitgestellte Unicode-Zeichenfolge ein benannter Registrierungseintrag ist, dessen Wert ein Dateiname ist. Für diese Spezifikation sind die zurückgegebenen Daten der Inhalt der benannten Datei.

Wenn VideoPortGetRegistryParameters die HwVidQueryNamedValueCallback-Funktion aufruft, werden alle Konfigurationsdaten verarbeitet. Beispielsweise können HwVidQueryNamedValueCallback- abgerufene Daten verwenden, um die Zugriffsbereiche des Miniporttreibers zu bestimmen und die Zugriffsbereiche des Emulators (falls vorhanden) einzurichten, den Vektor zu unterbrechen oder IRQL (falls vorhanden) zu unterbrechen, usw. im VIDEO_PORT_CONFIG_INFO Puffer sowie in der Geräteerweiterung des Miniporttreibers, bevor die Steuerung an die HwVidFindAdapter Funktion zurückgegeben wird.

HwVidInitialize- kann auch VideoPortGetRegistryParameters aufrufen, wobei IsFileNameParameter auf TRUE festgelegt ist, sodass der vom Miniport-Treiber bereitgestellte HwVidQueryNamedValueCallback-Funktion den gepufferten Inhalt einer benannten Datei zum Einrichten von Mikrocode auf dem Adapter verwenden kann.

Die zurückgegebene ValueData- befindet sich im Stapel, sodass lokal darauf verwiesen werden kann. HwVidQueryNamedValueCallback- kann einige oder alle zurückgegebenen Informationen zur Verwendung durch andere Miniporttreiberfunktionen in der Eingabe HwDeviceExtension- speichern oder die Eingabe Kontext- als Zeiger auf einen Ort verwenden, an dem die Daten gespeichert werden können.

HwVidQueryNamedValueCallback sollte seitenfähig gemacht werden.