VideoPortSetRegistryParameters-Funktion (video.h)

Die Funktion "VideoPortSetRegistryParameters" 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 mit einer null-beendeten Unicode-Zeichenfolge, die den Werteintrag benannt, für den Daten in der 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 in Bytes der daten 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.

Bemerkungen

VideoPortSetRegistryParameters sucht unter dem Adapterschlüssel der Registrierung nach dem wertnamen, der im ValueName-Parameter angegeben ist. Wenn der Wertname, nach dem gesucht wird, nicht vorhanden ist, erstellt diese Funktion diese Funktion automatisch. Wenn der Wertname gefunden oder erstellt wird, werden die Inhalte des ValueData-Parameters in den Wertnamen kopiert.

Für Windows XP- und höher-Betriebssystemversionen muss der im ValueName-Parameter angegebene Wertname nicht direkt dem Adapterschlüssel zugeordnet werden. Stattdessen kann ValueName einem Unterschlüssel zugeordnet werden, dessen Pfad den Adapterschlüssel enthält. Wenn die ValueName-Zeichenfolge eine oder mehrere Backslashes enthält, sucht VideoPortSetRegistryParameters nach oder erstellt den Unterschlüssel, dessen Wertname am Ende der Zeichenfolge liegt.

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

In Windows 2000 und höher gibt VideoPortSetRegistryParameters ERROR_INVALID_PARAMETER zurück, wenn die in den ValueName-Parameter übergebene Zeichenfolge mit "DefaultSettings" beginnt. (beachten Sie, dass der Zeitraum 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, es gibt jedoch keine Notwendigkeit für diese Funktion in Windows 2000 und höher.

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

VideoPortSetRegistryParameters können nicht von den HwVidInterrupt - oder HwVidTimer-Funktionen eines Miniporttreibers oder von VideoPortQueueDpc oder von einem Rückruf auf VideoPortSynchronizeExecution aufgerufen werden.

Anforderungen

   
Unterstützte Mindestversion (Client) Verfügbar in Windows 2000 und späteren Versionen der Windows-Betriebssysteme.
Zielplattform Desktop
Header video.h (einschließlich Video.h)
Bibliothek Videoprt.lib
DLL Videoprt.sys
IRQL PASSIVE_LEVEL

Siehe auch

HwVidFindAdapter

HwVidInitialize

VideoPortFlushRegistry

VideoPortGetRegistryParameters