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 de retorno
WdfWmiInstanceRegister retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, esse método poderá 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 .
Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.
Observações
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 Register membro da estrutura WDF_WMI_INSTANCE_CONFIG da instância para 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 ao WMI no 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 no > PASSIVE_LEVEL IRQL.
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 |
|---|---|
| da Plataforma de Destino | Universal |
| versão mínima do KMDF | 1.0 |
| cabeçalho | wdfwmi.h (inclua Wdf.h) |
| biblioteca | Wdf01000.sys (consulte o Controle de Versão da Biblioteca da Estrutura.) |
| IRQL | <=DISPATCH_LEVEL |
| regras de conformidade de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |