通过

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 中返回的值。 例如，如果调用方请求了六个实例，并且其中一个作为 FirstInstanceId 的值返回，则调用方应使用值 1-6 作为其唯一实例标识符。

要求

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

另请参阅

IoWmiSuggestInstanceName