Fungsi IoInvalidateDeviceRelations (wdm.h)

  • Artikel

Rutinitas IoInvalidateDeviceRelations memberi tahu manajer PnP bahwa hubungan untuk perangkat (seperti relasi bus, hubungan ejeksi, hubungan penghapusan, dan hubungan perangkat target) telah berubah.

Sintaks

void IoInvalidateDeviceRelations(
  [in] PDEVICE_OBJECT       DeviceObject,
  [in] DEVICE_RELATION_TYPE Type
);

Parameter

[in] DeviceObject

Arahkan ke PDO untuk perangkat.

[in] Type

Menentukan nilai enumerasi DEVICE_RELATION_TYPE yang menjelaskan jenis relasi yang telah berubah. Nilai yang mungkin termasuk BusRelations, EjectionRelations, RemovalRelations, dan TargetDeviceRelation. Dimulai dengan Windows 7, nilai PowerRelations juga didukung.

Nilai kembali

Tidak ada

Keterangan

Untuk beberapa jenis hubungan, seperti BusRelations, rutinitas ini menyebabkan manajer PnP atau manajer daya mengumpulkan informasi hubungan yang diperbarui dengan mengirim permintaan IRP_MN_QUERY_DEVICE_RELATIONS ke driver untuk perangkat. Untuk jenis hubungan lainnya, seperti EjectionRelations, manajer PnP tidak perlu segera mengumpulkan informasi hubungan baru; manajer PnP meminta driver untuk hubungan ejeksi hanya ketika sedang bersiap untuk mengeluarkan perangkat.

Setelah sopir bus memanggil IoInvalidateDeviceRelations untuk memberi tahu manajer PnP bahwa perangkat telah menghilang, pengemudi bus harus terus menangani RUNP PnP untuk perangkat tersebut sampai menerima permintaan IRP_MN_REMOVE_DEVICE . Menanggapi IRP ini, pengemudi bus kembali STATUS_NO_SUCH_DEVICE. Hingga pengemudi bus berhasil menyelesaikan permintaan IRP_MN_REMOVE_DEVICE , pengemudi bus dapat mengakses ekstensi perangkat untuk memeriksa benderanya untuk perangkat.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows 2000.
Target Platform Universal
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= DISPATCH_LEVEL
Aturan kepatuhan DDI HwStorPortProhibitedDDIs(storport)

Lihat juga

IRP_MN_QUERY_DEVICE_RELATIONS

IRP_MN_REMOVE_DEVICE