Fungsi VideoPortSetRegistryParameters (video.h)

  • Artikel

Fungsi VideoPortSetRegistryParameters menulis informasi di bawah kunci adaptor dalam registri.

Sintaks

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

Parameter

HwDeviceExtension

Arahkan ke ekstensi perangkat driver miniport.

[in] ValueName

Penunjuk ke buffer yang berisi string Unicode yang dihentikan null yang menamai entri nilai tempat data ditulis dalam registri.

[in] ValueData

Penunjuk ke buffer yang berisi nilai yang akan ditulis untuk entri ValueName .

ValueLength

Menentukan ukuran, dalam byte, data yang akan ditulis ke registri.

Nilai kembali

VideoPortSetRegistryParameters mengembalikan NO_ERROR jika data yang diberikan berhasil ditulis ke registri. Jika tidak, itu dapat mengembalikan ERROR_INVALID_PARAMETER.

Keterangan

VideoPortSetRegistryParameters mencari di bawah kunci adaptor registri untuk nama nilai yang ditentukan dalam parameter ValueName . Jika nama nilai yang dicari tidak ada, fungsi ini membuatnya secara otomatis. Saat nama nilai ditemukan atau dibuat, konten parameter ValueData disalin ke nama nilai.

Untuk Windows XP dan versi sistem operasi yang lebih baru, nama nilai yang ditentukan dalam parameter ValueName tidak perlu dikaitkan secara langsung dengan kunci adaptor . Sebagai gantinya, ValueName dapat dikaitkan dengan subkunci yang jalurnya menyertakan kunci adaptor . Jika string ValueName berisi satu atau beberapa garis miring terbelakang, VideoPortSetRegistryParameters mencari atau membuat subkunci yang nama nilainya berada di akhir string.

Misalnya, jika ValueName diatur ke string "SubKey1\Value1", fungsi ini mencari SubKey1 di bawah kunci adaptor di registri, membuat SubKey1 jika tidak ada. Fungsi kemudian mencari nama nilai Value1 , membuatnya jika perlu. VideoPortSetRegistryParameters kemudian menyalin konten parameter ValueData ke registri. Jalur yang ditentukan dalam parameter ValueName dapat merujuk ke nama nilai jumlah tingkat arbitrer di bawah kunci adaptor , tetapi perilaku fungsi ini pada dasarnya sama. Jika pada titik mana pun subkunci atau nama nilai tidak ditemukan, subkunci dibuat secara otomatis.

Di Windows 2000 dan yang lebih baru, VideoPortSetRegistryParameters mengembalikan ERROR_INVALID_PARAMETER jika string yang diteruskan dalam parameter ValueName dimulai dengan "DefaultSettings." (perhatikan bahwa periode adalah bagian dari string). Dalam sistem operasi yang lebih lama dari Windows 2000, driver miniport video dapat meneruskan nama nilai yang dimulai dengan "DefaultSettings." untuk menentukan resolusi default untuk monitor, tetapi tidak perlu kemampuan tersebut di Windows 2000 dan yang lebih baru.

Dalam build yang diperiksa dari versi sistem operasi apa pun, nama nilai yang dimulai dengan "DefaultSettings." menyebabkan kegagalan pernyataan.

VideoPortSetRegistryParameters tidak dapat dipanggil dari fungsi HwVidInterrupt atau HwVidTimer driver miniport, atau dari VideoPortQueueDpc, atau dari panggilan balik ke VideoPortSynchronizeExecution.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Windows 2000 dan versi yang lebih baru dari sistem operasi Windows.
Target Platform Desktop
Header video.h (sertakan Video.h)
Pustaka Videoprt.lib
DLL Videoprt.sys
IRQL PASSIVE_LEVEL

Lihat juga

HwVidFindAdapter

HwVidInitialize

VideoPortFlushRegistry

VideoPortGetRegistryParameters