Função IoWMIAllocateInstanceIds (wdm.h)

Artigo
02/07/2025

A rotina IoWMIAllocateInstanceIds aloca uma ou mais IDs de instância exclusivas para o GUID.

Sintaxe

NTSTATUS IoWMIAllocateInstanceIds(
  [in]  LPCGUID Guid,
  [in]  ULONG   InstanceCount,
  [out] ULONG   *FirstInstanceId
);

Parâmetros

[in] Guid

Ponteiro para o GUID para o qual gerar identificadores de instância.

[in] InstanceCount

Especifica quantos identificadores de instância devem ser fornecidos.

[out] FirstInstanceId

Ponteiro para o identificador de primeira instância que o driver deve usar.

Valor de retorno

IoWMIAllocateInstanceIds retorna um código de status da seguinte lista:

Código de retorno	Descrição
STATUS_SUCCESS	Indica que o WMI forneceu com êxito identificadores de instância exclusivos para o GUID especificado.
STATUS_UNSUCCESSFUL	Indica que os serviços WMI não estão disponíveis.
STATUS_INSUFFICIENT_RESOURCES	Indica que recursos insuficientes estavam disponíveis para fornecer ao chamador IDs de instância.

Observações

Se mais de uma instância tiver sido solicitada no InstanceCount e a rotina for concluída com êxito, FirstInstanceId apontará para a primeira instância que o chamador deve usar. Para cada instância solicitada além de uma, o chamador deve incrementar o valor retornado em *FirstInstanceId. Por exemplo, se o chamador solicitou seis instâncias e uma foi retornada como o valor de FirstInstanceId, o chamador deverá usar os valores de 1 a 6 como identificadores de instância exclusivos.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível a partir do Windows 2000.
da Plataforma de Destino	Universal
cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
biblioteca	NtosKrnl.lib
de DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
regras de conformidade de DDI	HwStorPortProhibitedDIs(storport), IrqlIoPassive5(wdm), PowerIrpDDis(wdm), SpNoWait(storport), StorPortStartIo(storport)

Consulte também

IoWmiSuggestInstanceName

Compartilhar via