共用方式為


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