Fungsi IoWMIDeviceObjectToInstanceName (wdm.h)

  • Artikel

Rutinitas IoWMIDeviceObjectToInstanceName menentukan nama instans untuk instans kelas WMI yang diterapkan oleh driver yang ditentukan oleh objek perangkat.

Sintaks

NTSTATUS IoWMIDeviceObjectToInstanceName(
  [in]  PVOID           DataBlockObject,
  [in]  PDEVICE_OBJECT  DeviceObject,
  [out] PUNICODE_STRING InstanceName
);

Parameter

[in] DataBlockObject

Penunjuk ke objek blok data WMI. Pemanggil membuka objek blok data untuk kelas WMI dengan IoWMIOpenBlock.

[in] DeviceObject

Menentukan objek perangkat. Rutinitas mengembalikan nama instans untuk driver yang sesuai dengan objek perangkat.

[out] InstanceName

Arahkan ke struktur UNICODE_STRING yang digunakan rutinitas untuk mengembalikan nama instans. Penelepon membebaskan buffer yang dikembalikan dalam UNICODE_STRING.

Nilai kembali

Rutinitas mengembalikan kode NTSTATUS. Kemungkinan nilai yang dikembalikan meliputi:

Menampilkan kode Deskripsi
STATUS_SUCCESS
 Operasi berhasil. Rutin menyimpan nama instans dalam UNICODE_STRING yang ditentukan oleh parameter InstanceName .
STATUS_WMI_INSTANCE_NOT_FOUND
 Driver tidak mengimplementasikan instans apa pun dari kelas WMI yang ditentukan oleh DataBlockObject.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia di Windows XP dan versi yang lebih baru dari sistem operasi Windows.
Target Platform Universal
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Lihat juga

DEVICE_OBJECT

IoWMIHandleToInstanceName

IoWMIOpenBlock