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

Artigo
02/27/2024

[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 como 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 para o qual o InBuffer aponta.

[in] InBuffer

Um ponteiro para o buffer de entrada.

Retornar valor

A função de retorno de chamada EvtWmiInstanceSetInstance deve retornar STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, essa função deverá retornar um valor status para o qual NT_SUCCESS(status) é igual a FALSE. Se o buffer de entrada para o qual o parâmetro InBuffer 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.

Comentários

Para registrar uma função de retorno de chamada EvtWmiInstanceSetInstance , o driver deve colocar o endereço da função em uma estrutura WDF_WMI_INSTANCE_CONFIG antes de chamar WdfWmiInstanceCreate.

A estrutura não sincroniza chamadas para 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 EvtWmiInstanceSetInstance forem dinâmicos e compartilhados com outras funções de retorno de chamada, o driver poderá usar 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 EvtWmiInstanceSetInstance , consulte Supporting WMI in Framework-Based Drivers.