VideoPortSetRegistryParameters-Funktion (video.h)

Die VideoPortSetRegistryParameters-Funktion schreibt Informationen unter dem Adapterschlüssel in der Registrierung.

Syntax

VIDEOPORT_API VP_STATUS VideoPortSetRegistryParameters(
       PVOID HwDeviceExtension,
  [in] PWSTR ValueName,
  [in] PVOID ValueData,
       ULONG ValueLength
);

Parameter

HwDeviceExtension

Zeiger auf die Geräteerweiterung des Miniporttreibers.

[in] ValueName

Zeiger auf einen Puffer, der eine unicode-Zeichenfolge mit NULL-Beendigung enthält, die den Werteintrag benennt, für den Daten in die Registrierung geschrieben werden.

[in] ValueData

Zeiger auf einen Puffer, der die Werte enthält, die für den ValueName-Eintrag geschrieben werden sollen.

ValueLength

Gibt die Größe der Daten in Bytes an, die in die Registrierung geschrieben werden sollen.

Rückgabewert

VideoPortSetRegistryParameters gibt NO_ERROR zurück, wenn die angegebenen Daten erfolgreich in die Registrierung geschrieben wurden. Andernfalls kann ERROR_INVALID_PARAMETER zurückgegeben werden.

Hinweise

VideoPortSetRegistryParameters sucht unter dem Adapterschlüssel der Registrierung nach dem wertigen Namen, der im ValueName-Parameter angegeben ist. Wenn der gesuchte Wertname nicht vorhanden ist, erstellt diese Funktion ihn automatisch. Wenn der Wertname gefunden oder erstellt wird, wird der Inhalt des ValueData-Parameters in den Wertnamen kopiert.

Für Windows XP und höhere Betriebssystemversionen muss der in den ValueName-Parametern angegebene Wertname nicht direkt dem Adapterschlüssel zugeordnet sein. Stattdessen kann ValueName einem Unterschlüssel zugeordnet werden, dessen Pfad den Adapterschlüssel enthält. Wenn die ValueName-Zeichenfolge einen oder mehrere umgekehrte Schrägstriche enthält, sucht VideoPortSetRegistryParameters nach dem Unterschlüssel oder erstellt den Unterschlüssel, dessen Wertname sich am Ende der Zeichenfolge befindet.

Wenn ValueName beispielsweise auf die Zeichenfolge "SubKey1\Value1" festgelegt ist, sucht diese Funktion unter dem Adapterschlüssel in der Registrierung nach SubKey1 und erstellt SubKey1, falls er nicht vorhanden ist. Die Funktion sucht dann nach dem Wertnamen Value1 und erstellt ihn bei Bedarf. VideoPortSetRegistryParameters kopiert dann den Inhalt des ValueData-Parameters in die Registrierung. Der im ValueName-Parameter angegebene Pfad kann auf einen Wertnamen verweisen, der eine beliebige Anzahl von Ebenen unterhalb des Adapterschlüssels aufweist, aber das Verhalten dieser Funktion ist im Wesentlichen identisch. Wenn zu irgendeinem Zeitpunkt kein Unterschlüssel oder Wertname gefunden wird, wird er automatisch erstellt.

In Windows 2000 und höher gibt VideoPortSetRegistryParameters ERROR_INVALID_PARAMETER zurück, wenn die im ValueName-Parameter übergebene Zeichenfolge mit "DefaultSettings" beginnt. (Beachten Sie, dass der Punkt Teil der Zeichenfolge ist). In Betriebssystemen vor Windows 2000 kann ein Video-Miniporttreiber einen Wertnamen übergeben, der mit "DefaultSettings" beginnt, um die Standardauflösung für einen Monitor anzugeben. In Windows 2000 und höher ist diese Funktion jedoch nicht erforderlich.

In einem überprüften Build einer beliebigen Version des Betriebssystems verursacht ein Wertname, der mit "DefaultSettings" beginnt, einen Assertionsfehler.

VideoPortSetRegistryParameters kann nicht von den Funktionen HwVidInterrupt oder HwVidTimer eines Miniporttreibers oder von VideoPortQueueDpc oder von einem Rückruf auf VideoPortSynchronizeExecution aufgerufen 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 (einschließen von Video.h)
Bibliothek	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL

Weitere Informationen

HwVidFindAdapter

HwVidInitialize

VideoPortFlushRegistry

VideoPortGetRegistryParameters