VideoPortSetRegistryParameters-Funktion (video.h)
Die VideoPortSetRegistryParameters Funktion schreibt Informationen unter dem Adapter Schlüssel in der Registrierung.
Syntax
VIDEOPORT_API VP_STATUS VideoPortSetRegistryParameters(
PVOID HwDeviceExtension,
[in] PWSTR ValueName,
[in] PVOID ValueData,
ULONG ValueLength
);
Parameter
HwDeviceExtension
Zeigen Sie auf die Geräteerweiterung des Miniporttreibers.
[in] ValueName
Zeigen Sie auf einen Puffer, der eine mit Null beendete Unicode-Zeichenfolge enthält, die den Werteintrag benennt, für den Daten in der Registrierung geschrieben werden.
[in] ValueData
Zeigen Sie 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.
Bemerkungen
VideoPortSetRegistryParameters sucht unter dem Adapter der Registrierung Schlüssel nach dem wertnamen, der im parameter ValueName angegeben ist. Wenn der gesuchte Wertname nicht vorhanden ist, erstellt diese Funktion sie automatisch. Wenn der Wertname gefunden oder erstellt wird, werden die Inhalte des ValueData Parameter in den Wertnamen kopiert.
Für Windows XP- und höhere Betriebssystemversionen muss der im ValueName Parameter angegebene Wertname nicht direkt mit dem Adapter Schlüssel verknüpft werden. Stattdessen kann ValueName- einem Unterschlüssel zugeordnet werden, dessen Pfad den Adapter Schlüssel enthält. Wenn die ValueName- Zeichenfolge einen oder mehrere umgekehrte Schrägstriche enthält, sucht VideoPortSetRegistryParameters den Unterschlüssel, dessen Wertname sich am Ende der Zeichenfolge befindet, oder erstellt den Unterschlüssel.
Wenn beispielsweise ValueName- auf die Zeichenfolge "SubKey1\Value1" festgelegt ist, sucht diese Funktion nach SubKey1 unter dem Adapter Schlüssel in der Registrierung und erstellt SubKey1, wenn er nicht vorhanden ist. Die Funktion sucht dann bei Bedarf nach dem Wert1 Wertnamens. VideoPortSetRegistryParameters kopiert dann den Inhalt des ValueData-Parameters in die Registrierung. Der im parameter ValueName Parameter angegebene Pfad kann auf einen Wertnamen verweisen, der eine beliebige Anzahl von Ebenen unter dem Adapter Schlüssels aufweist, das Verhalten dieser Funktion ist jedoch im Wesentlichen identisch. Wenn zu einem beliebigen 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, aber in Windows 2000 und höher ist dies nicht erforderlich.
Bei einem überprüften Build einer beliebigen Version des Betriebssystems verursacht ein Wertname, der mit "DefaultSettings" beginnt.
VideoPortSetRegistryParameters können nicht von HwVidInterrupt-- oder HwVidTimer--Funktionen oder von VideoPortQueueDpc-oder von einem Rückruf zu VideoPortSynchronizeExecutionaufgerufen 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 |