ioWMIAllocateInstanceIds 函式 (wdm.h)

  • 發行項

IoWMIAllocateInstanceIds 例程會配置 GUID 唯一的一或多個實例識別碼。

語法

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

參數

[in] Guid

要為其產生實例標識碼之 GUID 的指標。

[in] InstanceCount

指定應該提供多少實例識別碼。

[out] FirstInstanceId

驅動程式應該使用的第一個實例標識碼指標。

傳回值

IoWMIAllocateInstanceIds 會從下列清單中傳回狀態代碼：

傳回碼 Description
STATUS_SUCCESS
 表示 WMI 已成功提供指定之 GUID 的唯一實例識別碼。
STATUS_UNSUCCESSFUL
 表示無法使用 WMI 服務。
STATUS_INSUFFICIENT_RESOURCES
 表示資源不足，無法提供呼叫端實例標識碼。

備註

如果在 InstanceCount 中要求大於一個實例，且例程成功完成， FirstInstanceId 會指向呼叫端應該使用的第一個實例。 針對要求超過一個實例的每個實例，呼叫端應該遞增 *FirstInstanceId 中傳回的值。 例如，如果呼叫端要求六個實例，而一個被傳回為 FirstInstanceId 的值，則呼叫端應該使用值 1-6 作為唯一的實例識別符。

規格需求

需求 值
最低支援的用戶端 從 Windows 2000 開始提供。
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI 合規性規則 HwStorPortProhibitedDDIs (storport) 、 IrqlIoPassive5 (wdm) 、 PowerIrpDDis (wdm ) 、 SpNoWait (storport) 、 StorPortStartIo (storport)

另請參閱

IoWmiSuggestInstanceName