EVT_WDF_DEVICE_FILTER_RESOURCE_REQUIREMENTS fungsi panggilan balik (wdffdo.h)

[Berlaku untuk KMDF saja]

Fungsi panggilan balik peristiwa EvtDeviceFilterAddResourceRequirements driver dapat menambahkan sumber daya ke serangkaian persyaratan sumber daya perangkat keras sebelum sistem menetapkan sumber daya ke perangkat.

Fungsi panggilan balik peristiwa EvtDeviceFilterRemoveResourceRequirements driver dapat menghapus sumber daya dari serangkaian persyaratan sumber daya perangkat keras sebelum sistem menetapkan sumber daya ke perangkat.

Sintaks

EVT_WDF_DEVICE_FILTER_RESOURCE_REQUIREMENTS EvtWdfDeviceFilterResourceRequirements;

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

Parameter

[in] Device

Handel ke objek perangkat kerangka kerja tempat sumber daya akan ditetapkan.

[in] IoResourceRequirementsList

Handel ke objek daftar persyaratan sumber daya, yang mewakili daftar persyaratan sumber daya perangkat.

Nilai kembali

Jika driver tidak mengalami kesalahan, driver harus mengembalikan STATUS_SUCCESS. Jika tidak, nilai NTSTATUS harus dikembalikan yang NT_SUCCESS evaluasi sebagai FALSE.

Untuk informasi selengkapnya tentang nilai pengembalian, lihat Melaporkan Kegagalan Perangkat.

Keterangan

Driver fungsi berbasis kerangka kerja dapat menyediakan fungsi panggilan balik EvtDeviceFilterAddResourceRequirements dan EvtDeviceFilterRemoveResourceRequirements. Untuk mendaftarkan fungsi panggilan balik ini, driver memanggil WdfFdoInitSetEventCallbacks.

Ketika kerangka kerja memanggil fungsi panggilan balik EvtDeviceFilterAddResourceRequirements driver, driver dapat menambahkan deskriptor sumber daya ke konfigurasi logis, dan dapat menyediakan konfigurasi logis tambahan. Item yang ditambahkan ini mewakili sumber daya yang diperlukan driver fungsi untuk membuat perangkat beroperasi.

Jika fungsi panggilan balik EvtDeviceFilterAddResourceRequirements driver menambahkan item ke daftar persyaratan sumber daya perangkat, dan jika manajer PnP menetapkan sumber daya ke daftar persyaratan perangkat, fungsi panggilan balik EvtDeviceRemoveAddedResources driver harus menghapus sumber daya yang ditambahkan dari daftar sumber daya perangkat.

Untuk menambahkan item ke atau menghapus item dari daftar persyaratan sumber daya, driver memanggil metode objek resource-requirements-list kerangka kerja dan metode objek daftar rentang sumber daya kerangka kerja, yang memanipulasi objek daftar persyaratan sumber daya yang diwakili oleh parameter IoResourceRequirementsList .

Untuk informasi selengkapnya tentang fungsi panggilan balik ini, lihat Memodifikasi Daftar Persyaratan Sumber Daya.

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

Untuk informasi tentang memodifikasi sumber daya interupsi (misalnya afinitas prosesor), lihat bagian Keterangan dari WdfInterruptSetPolicy.

Persyaratan

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

Lihat juga

EvtDeviceRemoveAddedResources