EVT_WDF_WMI_INSTANCE_EXECUTE_METHOD função de retorno de chamada (wdfwmi.h)

Artigo
08/08/2023

[Aplica-se somente ao KMDF]

A função de retorno de chamada EvtWmiInstanceExecuteMethod de um 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 do 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 para o qual o 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 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.

Retornar valor

A função de retorno de chamada EvtWmiInstanceExecuteMethod deve retornar STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, essa função deve retornar um valor status para o qual NT_SUCCESS(status) é igual a 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.

Comentários

Para registrar uma função de retorno de chamada EvtWmiInstanceExecuteMethod , o driver deve colocar o endereço da função em uma estrutura 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 outra função de retorno de chamada de evento do driver. Se os dados da função de retorno de chamada EvtWmiInstanceExecuteMethod forem dinâmicos e compartilhados com outras funções de retorno de chamada, o driver poderá usar os bloqueios de espera ou bloqueios de rotação da estrutura para sincronizar o acesso aos dados.

Para obter mais informações sobre a função de retorno de chamada EvtWmiInstanceExecuteMethod , consulte Supporting WMI in Framework-Based Drivers.