EVT_WDF_WMI_INSTANCE_EXECUTE_METHOD função de retorno de chamada (wdfwmi.h)
[Aplica-se somente ao KMDF]
A função de retorno de chamada EvtWmiInstanceExecuteMethod do driver executa um método especificado que o driver fornece para a instância de um provedor de dados WMI.
Sintaxe
EVT_WDF_WMI_INSTANCE_EXECUTE_METHOD EvtWdfWmiInstanceExecuteMethod;
NTSTATUS EvtWdfWmiInstanceExecuteMethod(
[in] WDFWMIINSTANCE WmiInstance,
[in] ULONG MethodId,
[in] ULONG InBufferSize,
[in] ULONG OutBufferSize,
[in, out] PVOID Buffer,
[out] PULONG BufferUsed
)
{...}
Parâmetros
[in] WmiInstance
Um identificador para um objeto de instância WMI.
[in] MethodId
Um valor que identifica um método em uma instância de provedor. Esse valor corresponde ao valor WmiMethodId especificado no arquivo MOF do provedor.
[in] InBufferSize
O número de bytes de dados de entrada.
[in] OutBufferSize
O número de bytes de dados de saída que o buffer que Buffer aponta pode conter.
[in, out] Buffer
Um ponteiro para um buffer usado para entrada, saída ou ambos, conforme determinado pelo método especificado. Se os dados de entrada e de saída forem fornecidos, o driver substituirá os dados de entrada com os dados de saída.
[out] BufferUsed
Um ponteiro para um local que recebe o número de bytes que o driver escreveu no buffer de saída. Se o tamanho do buffer de saída especificado pelo parâmetro OutBufferSize for muito pequeno, o driver definirá esse local como o tamanho do buffer necessário.
Valor de retorno
A função de retorno de chamada EvtWmiInstanceExecuteMethod 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. O driver deverá retornar STATUS_BUFFER_TOO_SMALL se o valor do parâmetro OutBufferSize indicar que o buffer de saída é muito pequeno para receber os dados.
Observações
Para registrar uma função de retorno de chamada EvtWmiInstanceExecuteMethod, o driver deve colocar o endereço da função em uma estrutura de WDF_WMI_INSTANCE_CONFIG antes de chamar WdfWmiInstanceCreate.
Depois que um driver executa o método de instância especificado pelo parâmetro MethodId, o driver deve usar o parâmetro BufferUsed para armazenar o número de bytes que foram gravados no buffer.
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 EvtWmiInstanceExecuteMethod 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 EvtWmiInstanceExecuteMethod, consulte Suporte ao WMI nodrivers Framework-Based .
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 |