IoWMISuggestInstanceName 函数 (wdm.h)

  • 项目

IoWMISuggestInstanceName 例程用于请求 WMI 建议一个基名称，驱动程序可以使用该名称为设备生成 WMI 实例名称。

语法

NTSTATUS IoWMISuggestInstanceName(
  [in, optional] PDEVICE_OBJECT  PhysicalDeviceObject,
  [in, optional] PUNICODE_STRING SymbolicLinkName,
  [in]           BOOLEAN         CombineNames,
  [out]          PUNICODE_STRING SuggestedInstanceName
);

参数

[in, optional] PhysicalDeviceObject

如果提供，则指向驱动程序的物理设备对象。

[in, optional] SymbolicLinkName

如果提供，则指向从 IoRegisterDeviceInterface 返回的符号链接名称。

[in] CombineNames

如果 为 TRUE ，则返回的建议名称将合并 PhysicalDeviceObject 和 SymbolicLinkName 信息。

[out] SuggestedInstanceName

指向缓冲区的指针，该缓冲区在成功完成后将包含包含建议的实例名称 的UNICODE_STRING 。 调用方负责在不再需要缓冲区时释放该缓冲区。

返回值

IoWMISuggestInstanceName 从以下列表中返回状态代码：

返回代码 说明
STATUS_SUCCESS
 指示 WMI 能够成功完成此函数。
STATUS_UNSUCCESSFUL
 指示 WMI 服务不可用。
STATUS_INSUFFICIENT_RESOURCES
 指示可用资源不足，无法向调用方提供包含 Unicode 字符串的缓冲区。
STATUS_NO_MEMORY
 指示可用资源不足，无法向调用方提供包含 Unicode 字符串的缓冲区。

注解

如果 CombineNames 参数为 TRUE ，则必须同时指定 PhysicalDeviceObject 和 SymbolicLinkName 。 否则，应仅指定其中一个。

要求

要求 值
最低受支持的客户端 从 Windows 2000 开始可用。
目标平台 通用
标头 wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h）
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

另请参阅

IoWMIAllocateInstanceIds