Функция IoWMIDeviceObjectToInstanceName (wdm.h)

Статья
02/07/2025

Подпрограмма IoWMIDeviceObjectToInstanceName определяет имя экземпляра класса WMI, реализованного драйвером, указанным объектом устройства.

Синтаксис

NTSTATUS IoWMIDeviceObjectToInstanceName(
  [in]  PVOID           DataBlockObject,
  [in]  PDEVICE_OBJECT  DeviceObject,
  [out] PUNICODE_STRING InstanceName
);

Параметры

[in] DataBlockObject

Указатель на объект блока данных WMI. Вызывающий объект открывает объект блока данных для класса WMI с IoWMIOpenBlock.

[in] DeviceObject

Указывает объект устройства. Подпрограмма возвращает имя экземпляра драйвера, соответствующего объекту устройства.

[out] InstanceName

Указатель на структуру UNICODE_STRING, которую подпрограмма использует для возврата имени экземпляра. Вызывающий объект освобождает возвращенный буфер в UNICODE_STRING.

Возвращаемое значение

Подпрограмма возвращает код NTSTATUS. Возможные возвращаемые значения:

Возвращаемый код	Описание
STATUS_SUCCESS	Операция завершилась успешно. Подпрограмма сохраняет имя экземпляра в UNICODE_STRING, заданном параметром имени экземпляра.
STATUS_WMI_INSTANCE_NOT_FOUND	Драйвер не реализует экземпляры класса WMI, указанного DataBlockObject.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows XP и более поздних версиях операционной системы Windows.
целевая платформа	Всеобщий
заголовка	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

См. также

DEVICE_OBJECT

IoWMIHandleToInstanceName

IoWMIOpenBlock

Поделиться через