VideoPortGetRegistryParameters-Funktion (video.h)

Artikel
02/29/2024

Die VideoPortGetRegistryParameters-Funktion ruft beim Start gerätespezifische Konfigurationsinformationen unter dem Adapterschlüssel in der Registrierung ab.

Syntax

VIDEOPORT_API VP_STATUS VideoPortGetRegistryParameters(
       PVOID                          HwDeviceExtension,
  [in] PWSTR                          ParameterName,
       UCHAR                          IsParameterFileName,
       PMINIPORT_GET_REGISTRY_ROUTINE GetRegistryRoutine,
       PVOID                          Context
);

Parameter

HwDeviceExtension

Zeiger auf die Geräteerweiterung des Miniporttreibers.

[in] ParameterName

Zeiger auf eine MIT NULL endende Unicode-Zeichenfolge, die den Werteintrag benennt, der aus der Registrierung abgerufen werden soll. Weitere Informationen finden Sie im Abschnitt Bemerkungen.

IsParameterFileName

Wenn der Wert TRUE ist, wird der normalerweise zurückgegebene Datenwert als Dateiname behandelt. In diesem Fall wird der gepufferte Inhalt dieser Datei und nicht der Parameter selbst zurückgegeben.

GetRegistryRoutine

Zeiger auf die HwVidQueryNamedValueCallback-Funktion des Miniporttreibers.

Context

Zeiger auf einen vom Aufrufer bestimmten Kontextparameter, der an callbackRoutine übergeben werden soll, in der Regel der VIDEO_PORT_CONFIG_INFO Puffer.

Rückgabewert

VideoPortGetRegistryParameters gibt NO_ERROR zurück, wenn die angeforderten Informationen erfolgreich gesammelt und die HwVidQueryNamedValueCallback-Funktion des Miniporttreibers aufgerufen wurde. Gibt andernfalls ERROR_INVALID_PARAMETER zurück.

Hinweise

VideoPortGetRegistryParameters kann nicht über die Funktionen HwVidInterrupt oder HwVidTimer eines Miniporttreibers oder über VideoPortQueueDpc oder über einen Rückruf von VideoPortSynchronizeExecution aufgerufen werden.

Bei Windows XP und höheren Betriebssystemversionen kann der ParameterName-Parameter einen Pfad enthalten, der genau auf eine oder mehrere Ebenen unterhalb des Adapterschlüssels auf einen Wertnamen verweist. Beispielsweise kann die Zeichenfolge "SubKey1\Value1" verwendet werden, um den Werteintrag für die Wertnummer Value1 unter dem Unterschlüssel SubKey1 abzurufen.

Der Registrierungsschlüssel, aus dem VideoPortGetRegistryParameters Konfigurationsinformationen abruft , kann keine Informationen über den entsprechenden Anzeigetreiber enthalten, da die Funktionen des Miniporttreibers HwVidFindAdapter ausgeführt werden, bevor ein Anzeigetreiber geladen wird.

Miniport-Treiber sollten keine Konfigurationsinformationen abfragen, die in den DefaultSettings-Einträgen gespeichert sind, die in späteren Versionen des Betriebssystems möglicherweise nicht unterstützt werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Desktop
Kopfzeile	video.h (Video.h einschließen)
Bibliothek	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL