共用方式為

IoWMIAllocateInstanceIds 函式 （wdm.h）

  • 發行項

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

語法

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

參數

[in] Guid

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

[in] InstanceCount

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

[out] FirstInstanceId

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

傳回值

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

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

言論

如果在 Instance Count 中要求大於一個實例，且例程順利完成，FirstInstanceId 指向呼叫端應該使用的第一個實例。 針對每個要求超過一個的實例，呼叫端應遞增 *FirstInstanceId 中所傳回的值，。 例如，如果呼叫端要求六個實例，一個傳回為 FirstInstanceId的值，則呼叫端應該使用值 1-6 作為他的唯一實例標識符。

要求

要求 價值
最低支援的用戶端 從 Windows 2000 開始提供。
目標平臺 普遍
標頭 wdm.h （包括 Wdm.h、Ntddk.h、Ntifs.h）
連結庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI 合規性規則 HwStorPortProhibitedDIS（storport）、IrqlIoPassive5（wdm）、PowerIrpDDis（wdm）、SpNoWait（storport）、StorPortStartIo（storport）

另請參閱

IoWmiSuggestInstanceName