Função WdfWmiInstanceRegister (wdfwmi.h)

[Aplica-se somente ao KMDF]

O método WdfWmiInstanceRegister registra uma instância especificada de um provedor de dados WMI com o serviço WMI do sistema.

Sintaxe

NTSTATUS WdfWmiInstanceRegister(
  [in] WDFWMIINSTANCE WmiInstance
);

Parâmetros

[in] WmiInstance

Um identificador para um objeto de instância WMI que o driver obteve de uma chamada anterior para WdfWmiInstanceCreate.

Valor retornado

WdfWmiInstanceRegister retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, esse método pode retornar um dos seguintes valores:

Código de retorno Descrição
STATUS_INVALID_DEVICE_REQUEST
A instância WMI especificada já foi registrada.
 

Esse método também pode retornar outros valores NTSTATUS.

Ocorre uma verificação de bug se o driver fornece um identificador de objeto inválido.

Comentários

As instâncias do provedor não estão disponíveis para clientes WMI até que tenham sido registradas. O driver deve chamar WdfWmiInstanceRegister ou definir o membro Register da estrutura de WDF_WMI_INSTANCE_CONFIG da instância como TRUE.

Para obter mais informações sobre o método WdfWmiInstanceRegister , consulte Registrando instâncias do provedor. Para obter mais informações sobre o WMI, consulte Suporte à WMI em drivers de Framework-Based.

WdfWmiInstanceRegister registra a instância do provedor de forma síncrona (ou seja, antes de retornar) se ela for chamada em IRQL = PASSIVE_LEVEL e de forma assíncrona se for chamada no IRQL > PASSIVE_LEVEL.

Exemplos

O exemplo de código a seguir registra uma instância especificada de um provedor de dados WMI com o serviço WMI do sistema.

NTSTATUS  status;

status = WdfWmiInstanceRegister(wmiInstance);

Requisitos

   
Plataforma de Destino Universal
Versão mínima do KMDF 1,0
Cabeçalho wdfwmi.h (include Wdf.h)
Biblioteca Wdf01000.sys (consulte o Controle de Versão da Biblioteca de Estruturas).)
IRQL <=DISPATCH_LEVEL
Regras de conformidade DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Confira também

WDF_WMI_INSTANCE_CONFIG

WdfWmiInstanceCreate

WdfWmiInstanceDeregister