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