PMINIPORT_GET_REGISTRY_ROUTINE fungsi panggilan balik (video.h)

Artikel
08/07/2023

HwVidQueryNamedValueCallback memproses data yang ditentukan yang diambil dari registri.

Sintaks

PMINIPORT_GET_REGISTRY_ROUTINE PminiportGetRegistryRoutine;

VP_STATUS PminiportGetRegistryRoutine(
  PVOID HwDeviceExtension,
  PVOID Context,
  PWSTR ValueName,
  PVOID ValueData,
  ULONG ValueLength
)
{...}

Parameter

HwDeviceExtension

Arahkan ke area penyimpanan per adaptor driver miniport. Untuk informasi selengkapnya, lihat Ekstensi Perangkat.

Context

Penunjuk ke konteks yang ditentukan driver yang ditentukan sebagai input ke fungsi VideoPortGetRegistryParameters .

ValueName

Penunjuk ke string Unicode yang dihentikan NULL yang memberi nama entri.

ValueData

Arahkan ke data buffer yang terkait dengan ValueName, yang disediakan oleh VideoPortGetRegistryParameters.

ValueLength

Menentukan ukuran dalam byte buffer di ValueData.

Nilai kembali

HwVidQueryNamedValueCallback mengembalikan status operasi.

Keterangan

HwVidQueryNamedValueCallback adalah fungsi driver miniport opsional yang diteruskan dalam panggilan ke VideoPortGetRegistryParameters.

VideoPortGetRegistryParameters memanggil HwVidQueryNamedValueCallback setelah mengumpulkan informasi konfigurasi yang tersedia tentang ValueName yang diberikan di kunci adapter registri .

HwVidFindAdapter atau HwVidInitialize dapat memanggil VideoPortGetRegistryParameters dengan fungsi HwVidQueryNamedValueCallback yang disediakan driver, penunjuk ke ekstensi perangkat dan data konteks yang disediakan driver (yang dapat menjadi buffer VIDEO_PORT_CONFIG_INFO ), dan penunjuk ke string Unicode yang menamai nilai yang akan diambil dari registri.

Argumen IsFileNameParameter HwVidAdapter atau HwVidInitialize dapat mengatur argumen IsFileNameParameterVideoPortGetRegistryParameters ke TRUE jika string Unicode yang disediakan driver adalah entri registri bernama yang nilainya adalah nama file. Untuk spesifikasi ini, data yang dikembalikan akan menjadi konten file bernama.

Ketika VideoPortGetRegistryParameters memanggil fungsi HwVidQueryNamedValueCallback , video memproses data konfigurasi apa pun yang tersedia. Misalnya, HwVidQueryNamedValueCallback dapat menggunakan data yang diambil untuk menentukan rentang akses driver miniport dan untuk menyiapkan rentang akses emulatornya (jika ada), mengganggu vektor atau mengganggu IRQL (jika ada), dan sebagainya dalam buffer VIDEO_PORT_CONFIG_INFO, serta di ekstensi perangkat driver miniport, sebelum mengembalikan kontrol ke fungsi HwVidFindAdapter .

HwVidInitialize mungkin juga memanggil VideoPortGetRegistryParameters dengan IsFileNameParameter diatur ke TRUE sehingga fungsi HwVidQueryNamedValueCallback yang disediakan driver miniport dapat menggunakan konten buffer file bernama untuk menyiapkan kode mikro pada adaptor.

ValueData yang dikembalikan ada di tumpukan, sehingga dapat direferensikan secara lokal. HwVidQueryNamedValueCallback dapat menyimpan beberapa atau semua informasi yang dikembalikan untuk digunakan oleh fungsi driver miniport lainnya dalam input HwDeviceExtension atau menggunakan Konteks input sebagai penunjuk ke lokasi tempat data dapat disimpan.

HwVidQueryNamedValueCallback harus dibuat dapat di-pageable.