EVT_WDF_DEVICE_RESOURCE_REQUIREMENTS_QUERY fungsi panggilan balik (wdfpdo.h)

[Hanya berlaku untuk KMDF]

Fungsi panggilan balik peristiwa EvtDeviceResourceRequirementsQuery driver bus membuat daftar persyaratan sumber daya yang mewakili sumber daya perangkat keras yang diperlukan perangkat.

Sintaks

EVT_WDF_DEVICE_RESOURCE_REQUIREMENTS_QUERY EvtWdfDeviceResourceRequirementsQuery;

NTSTATUS EvtWdfDeviceResourceRequirementsQuery(
  [in] WDFDEVICE Device,
  [in] WDFIORESREQLIST IoResourceRequirementsList
)
{...}

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja.

[in] IoResourceRequirementsList

Handel ke objek daftar persyaratan sumber daya kerangka kerja yang mewakili daftar persyaratan sumber daya kosong.

Nilai kembali

Jika driver tidak mengalami kesalahan, driver harus mengembalikan STATUS_SUCCESS (apakah itu menentukan sumber daya perangkat keras yang diperlukan atau tidak). Jika driver mengalami kesalahan, driver harus mengembalikan nilai NTSTATUS yang NT_SUCCESS evaluasi sebagai FALSE.

Untuk informasi selengkapnya tentang nilai pengembalian fungsi panggilan balik ini, lihat Melaporkan Kegagalan Perangkat.

Keterangan

Driver bus berbasis kerangka kerja dapat menyediakan fungsi panggilan balik EvtDeviceResourceRequirementsQuery . Untuk mendaftarkan fungsi panggilan balik ini, driver bus memanggil WdfPdoInitSetEventCallbacks.

Kerangka kerja memanggil fungsi panggilan balik EvtDeviceResourceRequirementsQuery driver bus untuk mendapatkan daftar persyaratan sumber daya untuk perangkat.

Driver harus mengisi objek daftar persyaratan sumber daya yang disediakan dengan konfigurasi logis sumber daya perangkat keras yang akan memungkinkan perangkat beroperasi dengan benar.

Untuk membuat daftar persyaratan sumber daya, driver memanggil metode objek daftar rentang sumber daya kerangka kerja, yang menambahkan deskriptor sumber daya ke konfigurasi logis, dan metode objek daftar persyaratan sumber daya kerangka kerja, yang menambahkan konfigurasi logis ke daftar persyaratan sumber daya.

Untuk informasi selengkapnya tentang sumber daya perangkat keras dan membuat daftar persyaratan sumber daya, lihat Sumber Daya Perangkat Keras untuk Driver Framework-Based.

Jika driver berjalan pada versi sistem operasi yang lebih lama dari Windows 7, driver bus dapat menggunakan EvtDeviceResourceRequirementsQuery untuk mengatur properti perangkat pada perangkat anak sebelum menghitung anak.

Untuk mengatur properti perangkat pada Windows 7 atau yang lebih baru, driver bus dapat menyediakan rutinitas praprosem untuk IRP_MN_DEVICE_ENUMERATED.

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Versi KMDF minimum	1,0
Header	wdfpdo.h (termasuk Wdf.h)
IRQL	PASSIVE_LEVEL

Lihat juga

EvtDeviceResourcesQuery