EVT_WDF_DEVICE_REMOVE_ADDED_RESOURCES fungsi panggilan balik (wdffdo.h)

  • Artikel

[Hanya berlaku untuk KMDF]

Fungsi panggilan balik peristiwa EvtDeviceRemoveAddedResources driver menghapus sumber daya perangkat keras yang ditambahkan oleh fungsi panggilan balik EvtDeviceFilterAddResourceRequirements driver.

Sintaks

EVT_WDF_DEVICE_REMOVE_ADDED_RESOURCES EvtWdfDeviceRemoveAddedResources;

NTSTATUS EvtWdfDeviceRemoveAddedResources(
  [in] WDFDEVICE Device,
  [in] WDFCMRESLIST ResourcesRaw,
  [in] WDFCMRESLIST ResourcesTranslated
)
{...}

Parameter

[in] Device

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

[in] ResourcesRaw

Handel ke objek daftar sumber daya yang mengidentifikasi sumber daya perangkat keras mentah yang telah ditetapkan manajer PnP ke perangkat.

[in] ResourcesTranslated

Handel ke objek daftar sumber daya yang mengidentifikasi sumber daya perangkat keras yang diterjemahkan yang telah ditetapkan manajer PnP ke 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 EvtDeviceRemoveAddedResources . Untuk mendaftarkan fungsi panggilan balik ini, driver memanggil WdfFdoInitSetEventCallbacks.

Jika driver menyediakan fungsi panggilan balik EvtDeviceFilterAddResourceRequirements yang menambahkan sumber daya ke daftar persyaratan perangkat keras perangkat, driver juga harus menyediakan fungsi panggilan balik EvtDeviceRemoveAddedResources . Fungsi panggilan balik EvtDeviceRemoveAddedResources memeriksa daftar sumber daya yang telah ditetapkan manajer PnP ke perangkat, dan menghapus sumber daya dari daftar yang ditambahkan oleh fungsi panggilan balik EvtDeviceFilterAddResourceRequirements . Jika driver menghapus sumber daya, driver harus menghapusnya dari daftar sumber daya mentah dan diterjemahkan.

Untuk informasi selengkapnya tentang daftar sumber daya dan urutan sumber daya muncul, lihat sumber daya perangkat keras mentah dan terjemahan.

Kerangka kerja memanggil fungsi panggilan balik EvtDeviceRemoveAddedResources driver segera sebelum meneruskan daftar sumber daya perangkat ke driver bus. Fungsi panggilan balik ini menghapus sumber daya tambahan sehingga driver bus tidak akan mencoba menggunakannya.

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

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

Persyaratan

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

Lihat juga

EvtDeviceFilterAddResourceRequirements

EvtDeviceFilterRemoveResourceRequirements