VideoPortGetRegistryParameters-Funktion (video.h)
Die VideoPortGetRegistryParameters Funktion ruft gerätespezifische Konfigurationsinformationen unter dem Adapter Schlüssel in der Registrierung beim Start ab.
Syntax
VIDEOPORT_API VP_STATUS VideoPortGetRegistryParameters(
PVOID HwDeviceExtension,
[in] PWSTR ParameterName,
UCHAR IsParameterFileName,
PMINIPORT_GET_REGISTRY_ROUTINE GetRegistryRoutine,
PVOID Context
);
Parameter
HwDeviceExtension
Zeigen Sie auf die Geräteerweiterung des Miniporttreibers.
[in] ParameterName
Zeigen Sie auf eine MIT NULL beendete Unicode-Zeichenfolge, die den Werteintrag benennt, der aus der Registrierung abgerufen werden soll. Weitere Informationen finden Sie im Abschnitt Anmerkungen.
IsParameterFileName
Wenn der Wert TRUEist, wird der normalerweise zurückgegebene Datenwert als Dateiname behandelt. In diesem Fall werden die gepufferten Inhalte dieser Datei anstelle des Parameters selbst zurückgegeben.
GetRegistryRoutine
Zeiger auf die HwVidQueryNamedValueCallback-Funktion des Miniporttreibers.
Context
Zeiger auf einen vom Aufrufer bestimmten Kontextparameter, der an die CallbackRoutine-übergeben werden soll , in der Regel der VIDEO_PORT_CONFIG_INFO Puffer.
Rückgabewert
VideoPortGetRegistryParameters gibt NO_ERROR zurück, wenn sie die angeforderten Informationen erfolgreich gesammelt und die HwVidQueryNamedValueCallback-Funktion aufgerufen hat; andernfalls wird ERROR_INVALID_PARAMETER zurückgegeben.
Bemerkungen
VideoPortGetRegistryParameters können nicht von HwVidInterrupt-- oder HwVidTimer--Funktionen oder von VideoPortQueueDpcoder von einem Rückruf zu VideoPortSynchronizeExecutionaufgerufen werden.
Für Windows XP- und höhere Betriebssystemversionen kann der parameter ParameterName einen Pfad enthalten, der genau auf einen Wertnamen verweist, der mindestens eine Ebene unterhalb des Adapters Schlüssels verweist. Beispielsweise kann die Zeichenfolge "SubKey1\Value1" verwendet werden, um den Werteintrag für die Wert1-Wertnummer unter dem Unterschlüssel "SubKey1" abzurufen.
Der Registrierungsschlüssel, aus dem VideoPortGetRegistryParameters Konfigurationsinformationen abruft, kann keine Informationen über den entsprechenden Anzeigetreiber enthalten, da miniport-Treiber HwVidFindAdapter Funktionen 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 |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 2000 und höheren Versionen von Windows-Betriebssystemen. |
| Zielplattform- | Desktop |
| Header- | video.h (video.h einschließen) |
| Library | Videoprt.lib |
| DLL- | Videoprt.sys |
| IRQL- | PASSIVE_LEVEL |