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

Статья
02/07/2025

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	Указывает, что недостаточно ресурсов для предоставления вызывающим идентификаторам экземпляров.

Замечания

Если больше одного экземпляра было запрошено в InstanceCount и подпрограмма успешно завершена, FirstInstanceId указывает на первый экземпляр, который должен использовать вызывающий объект. Для каждого экземпляра, запрашиваемого за пределами одного, вызывающий объект должен увеличить значение, возвращаемое в *FirstInstanceId. Например, если вызывающий запрашивал шесть экземпляров и один возвращался в качестве значения FirstInstanceId, вызывающий объект должен использовать значения 1-6 в качестве его уникальных идентификаторов экземпляров.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно начиная с Windows 2000.
целевая платформа	Всеобщий
заголовка	wdm.h (include 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

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