EVT_WDF_WMI_INSTANCE_SET_INSTANCE função de retorno de chamada (wdfwmi.h)
[Aplica-se somente ao KMDF]
A função de retorno de chamada EvtWmiInstanceSetInstance de um driver define todos os dados de instância de um provedor de dados WMI para valores fornecidos por um cliente WMI.
Sintaxe
EVT_WDF_WMI_INSTANCE_SET_INSTANCE EvtWdfWmiInstanceSetInstance;
NTSTATUS EvtWdfWmiInstanceSetInstance(
[in] WDFWMIINSTANCE WmiInstance,
[in] ULONG InBufferSize,
[in] PVOID InBuffer
)
{...}
Parâmetros
[in] WmiInstance
Um identificador para um objeto de instância WMI.
[in] InBufferSize
O tamanho, em bytes, do buffer de entrada que InBuffer aponta.
[in] InBuffer
Um ponteiro para o buffer de entrada.
Valor de retorno
A função de retorno de chamada EvtWmiInstanceSetInstance deverá retornar STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, essa função deve retornar um valor de status para o qual NT_SUCCESS(status) é igual FALSE. Se o buffer de entrada para o qual o InBuffer parâmetro aponta for muito pequeno para conter todos os dados esperados pelo driver, a função de retorno de chamada deverá retornar STATUS_WMI_SET_FAILURE.
Observações
Para registrar uma função de retorno de chamada EvtWmiInstanceSetInstance, o driver deve colocar o endereço da função em uma estrutura de WDF_WMI_INSTANCE_CONFIG antes de chamar WdfWmiInstanceCreate.
A estrutura não sincroniza chamadas para as funções de retorno de chamada de evento WMI de um driver entre si ou com qualquer uma das outras funções de retorno de chamada de evento do driver. Se um EvtWmiInstanceSetInstance dados da função de retorno de chamada for dinâmico e compartilhado com outras funções de retorno de chamada, o driver poderá usar os bloqueios de espera da estrutura ou bloqueios de rotação para sincronizar o acesso aos dados.
Para obter mais informações sobre a função de retorno de chamada EvtWmiInstanceSetInstance, consulte Suporte ao WMI em Framework-Based Drivers.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| versão mínima do KMDF | 1.0 |
| cabeçalho | wdfwmi.h (inclua Wdf.h) |
| IRQL | PASSIVE_LEVEL |