通过

IoWMIAllocateInstanceIds 函数 （wdm.h）

  • 项目

IoWMIAllocateInstanceIds 例程分配 GUID 唯一的一个或多个实例 ID。

语法

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
 指示资源不足，无法向调用方提供实例 ID。

言论

如果在 InstanceCount 中请求了大于一个实例，并且例程成功完成，FirstInstanceId 指向调用方应使用的第一个实例。 对于请求超过一个实例的每个实例，调用方应递增 *FirstInstanceId中返回的值。 例如，如果调用方请求了 6 个实例，1 个实例作为 FirstInstanceId的值返回，则调用方应使用值 1-6 作为唯一实例标识符。

要求

要求 价值
最低支持的客户端 从 Windows 2000 开始可用。
目标平台 普遍
标头 wdm.h （包括 Wdm.h、Ntddk.h、Ntifs.h）
库 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI 符合性规则 HwStorPortProhibitedDDI（storport）、IrqlIoPassive5（wdm）、PowerIrpDDis（wdm）、SpNoWait（storport）、StorPortStartIo（storport）

另请参阅

IoWmiSuggestInstanceName