PMINIPORT_GET_REGISTRY_ROUTINE Rückruffunktion (video.h)

Artikel
03/01/2024

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

Syntax

PMINIPORT_GET_REGISTRY_ROUTINE PminiportGetRegistryRoutine;

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

Parameter

HwDeviceExtension

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

Context

Zeiger auf einen vom Treiber bestimmten Kontext, der als Eingabe für die VideoPortGetRegistryParameters-Funktion angegeben ist.

ValueName

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

ValueData

Zeiger auf die gepufferten Daten, die ValueName zugeordnet sind, die von VideoPortGetRegistryParameters bereitgestellt werden.

ValueLength

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

Rückgabewert

HwVidQueryNamedValueCallback gibt den status des Vorgangs zurück.

Hinweise

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

VideoPortGetRegistryParameters ruft HwVidQueryNamedValueCallback auf, nachdem verfügbare Konfigurationsinformationen über den angegebenen ValueName im Adapterschlüssel der Registrierung gesammelt wurden.

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

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

Wenn VideoPortGetRegistryParameters die HwVidQueryNamedValueCallback-Funktion aufruft , verarbeitet sie alle verfügbaren Konfigurationsdaten. Beispielsweise kann HwVidQueryNamedValueCallback abgerufene Daten verwenden, um die Zugriffsbereiche des Miniporttreibers zu bestimmen und die Emulatorzugriffsbereiche (falls vorhanden) einzurichten, Vektoren zu unterbrechen oder IRQL zu unterbrechen (falls vorhanden), 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 die vom Miniport-Treiber bereitgestellte HwVidQueryNamedValueCallback-Funktion den gepufferten Inhalt einer benannten Datei verwenden kann, um Microcode auf dem Adapter einzurichten.

Das 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 den Eingabekontext als Zeiger auf einen Speicherort verwenden, an dem die Daten gespeichert werden können.

HwVidQueryNamedValueCallback sollte als ausgelagert werden.