Função IoWMIAllocateInstanceIds (wdm.h)

  • Artigo

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.

Retornar valor

IoWMIAllocateInstanceIds retorna um código 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.

Comentários

Se mais de uma instância tiver sido solicitada em 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 seus identificadores de instância exclusivos.

Requisitos

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

Confira também

IoWmiSuggestInstanceName