Fungsi VideoPortGetRegistryParameters (video.h)

Artikel
02/27/2024

Fungsi VideoPortGetRegistryParameters mengambil informasi konfigurasi khusus perangkat di bawah kunci adaptor di registri saat startup.

Sintaks

VIDEOPORT_API VP_STATUS VideoPortGetRegistryParameters(
       PVOID                          HwDeviceExtension,
  [in] PWSTR                          ParameterName,
       UCHAR                          IsParameterFileName,
       PMINIPORT_GET_REGISTRY_ROUTINE GetRegistryRoutine,
       PVOID                          Context
);

Parameter

HwDeviceExtension

Arahkan ke ekstensi perangkat driver miniport.

[in] ParameterName

Penunjuk ke string Unicode yang dihentikan NULL yang menamai entri nilai yang akan diambil dari registri. Lihat bagian Keterangan untuk informasi lebih lanjut.

IsParameterFileName

Jika nilainya TRUE, nilai data yang biasanya dikembalikan diperlakukan sebagai nama file. Dalam hal ini, konten yang di-buffer dari file tersebut dikembalikan, bukan parameter itu sendiri.

GetRegistryRoutine

Arahkan ke fungsi HwVidQueryNamedValueCallback driver miniport.

Context

Arahkan ke parameter konteks yang ditentukan pemanggil untuk diteruskan ke CallbackRoutine, biasanya buffer VIDEO_PORT_CONFIG_INFO .

Mengembalikan nilai

VideoPortGetRegistryParameters mengembalikan NO_ERROR jika berhasil mengumpulkan informasi yang diminta dan memanggil fungsi HwVidQueryNamedValueCallback driver miniport; jika tidak, mengembalikan ERROR_INVALID_PARAMETER.

Keterangan

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

Untuk Windows XP dan versi sistem operasi yang lebih baru, parameter ParameterName dapat berisi jalur yang persis mereferensikan nama nilai satu atau beberapa tingkat di bawah kunci adaptor . Misalnya, string "SubKey1\Value1" dapat digunakan untuk mendapatkan entri nilai untuk nomor nilai Value1 di bawah subkunjuk SubKey1.

Kunci registri tempat VideoPortGetRegistryParameters mengambil informasi konfigurasi tidak boleh berisi informasi apa pun tentang driver tampilan yang sesuai, karena fungsi driver miniport HwVidFindAdapter dijalankan sebelum driver tampilan dimuat.

Driver Miniport tidak boleh mengkueri informasi konfigurasi yang disimpan dalam entri DefaultSettings , yang mungkin tidak didukung dalam versi sistem operasi yang lebih baru.

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