Função WdfWmiInstanceRegister (wdfwmi.h)

  • Artigo

[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.

Retornar valor

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.

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Comentários

As instâncias de 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 de provedor. Para obter mais informações sobre wmi, consulte Supporting WMI in Framework-Based Drivers.

WdfWmiInstanceRegister registrará 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 em 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

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Cabeçalho wdfwmi.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.)
IRQL <=DISPATCH_LEVEL
Regras de conformidade da DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Confira também

WDF_WMI_INSTANCE_CONFIG

WdfWmiInstanceCreate

WdfWmiInstanceDeregister