EVT_WDF_DEVICE_RESOURCES_QUERY fungsi panggilan balik (wdfpdo.h)
[Hanya berlaku untuk KMDF]
Fungsi panggilan balik peristiwa EvtDeviceResourcesQuery driver bus membuat daftar sumber daya yang mewakili konfigurasi boot perangkat tertentu.
Sintaks
EVT_WDF_DEVICE_RESOURCES_QUERY EvtWdfDeviceResourcesQuery;
NTSTATUS EvtWdfDeviceResourcesQuery(
[in] WDFDEVICE Device,
[in] WDFCMRESLIST Resources
)
{...}
Parameter
[in] Device
Handel ke objek perangkat kerangka kerja.
[in] Resources
Handel ke objek daftar sumber daya kerangka kerja yang mewakili daftar sumber daya kosong.
Nilai kembali
Jika driver tidak mengalami kesalahan, driver harus mengembalikan STATUS_SUCCESS (apakah itu menentukan sumber daya konfigurasi boot 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 EvtDeviceResourcesQuery . Untuk mendaftarkan fungsi panggilan balik ini, driver bus memanggil WdfPdoInitSetEventCallbacks.
Kerangka kerja memanggil fungsi panggilan balik EvtDeviceResourcesQuery driver bus untuk mendapatkan daftar sumber daya yang menentukan konfigurasi boot untuk perangkat.
Driver harus mengisi objek daftar sumber daya yang disediakan dengan sumber daya perangkat keras yang mewakili persyaratan boot untuk perangkat. Driver untuk perangkat PnP mendapatkan informasi persyaratan ini dari BIOS sistem.
Untuk membuat daftar sumber daya, driver memanggil metode objek daftar sumber daya kerangka kerja yang menambahkan sumber daya ke objek daftar sumber daya yang diwakili oleh parameter Sumber Daya . Untuk informasi selengkapnya tentang sumber daya perangkat keras dan membuat daftar sumber daya, lihat Sumber Daya Perangkat Keras untuk Driver Framework-Based.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Versi KMDF minimum | 1,0 |
| Header | wdfpdo.h (termasuk Wdf.h) |
| IRQL | PASSIVE_LEVEL |