Fungsi IoWMIAllocateInstanceIds (wdm.h)

  • Artikel

Rutinitas IoWMIAllocateInstanceIds mengalokasikan satu atau beberapa ID instans yang unik untuk GUID.

Sintaks

NTSTATUS IoWMIAllocateInstanceIds(
  [in]  LPCGUID Guid,
  [in]  ULONG   InstanceCount,
  [out] ULONG   *FirstInstanceId
);

Parameter

[in] Guid

Arahkan ke GUID untuk menghasilkan pengidentifikasi instans.

[in] InstanceCount

Menentukan berapa banyak pengidentifikasi instans yang harus disediakan.

[out] FirstInstanceId

Arahkan ke pengidentifikasi instans pertama yang harus digunakan driver.

Nilai kembali

IoWMIAllocateInstanceIds mengembalikan kode status dari daftar berikut:

Menampilkan kode Deskripsi
STATUS_SUCCESS
 Menunjukkan bahwa WMI berhasil menyediakan pengidentifikasi instans unik untuk GUID yang ditentukan.
STATUS_UNSUCCESSFUL
 Menunjukkan bahwa layanan WMI tidak tersedia.
STATUS_INSUFFICIENT_RESOURCES
 Menunjukkan bahwa sumber daya yang tidak mencukupi tersedia untuk menyediakan ID instans kepada pemanggil.

Keterangan

Jika lebih dari satu instans diminta di InstanceCount dan rutinitas berhasil diselesaikan, FirstInstanceId menunjuk ke instans pertama yang harus digunakan pemanggil. Untuk setiap instans yang diminta di luar satu instans, pemanggil harus menaikkan nilai yang dikembalikan dalam *FirstInstanceId. Misalnya, jika pemanggil meminta enam instans dan satu dikembalikan sebagai nilai FirstInstanceId, pemanggil harus menggunakan nilai 1-6 sebagai pengidentifikasi instans uniknya.

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 PASSIVE_LEVEL
Aturan kepatuhan DDI HwStorPortProhibitedDDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm), SpNoWait(storport), StorPortStartIo(storport)

Lihat juga

IoWmiSuggestInstanceName