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

[Aplica-se somente ao KMDF]

A função de retorno de chamada EvtWmiInstanceSetItem de um driver define um único item dos dados de instância de um provedor de dados WMI para um valor fornecido por um cliente WMI.

Sintaxe

EVT_WDF_WMI_INSTANCE_SET_ITEM EvtWdfWmiInstanceSetItem;

NTSTATUS EvtWdfWmiInstanceSetItem(
  [in] WDFWMIINSTANCE WmiInstance,
  [in] ULONG DataItemId,
  [in] ULONG InBufferSize,
  [in] PVOID InBuffer
)
{...}

Parâmetros

[in] WmiInstance

Um identificador para um objeto de instância WMI.

[in] DataItemId

Um valor que identifica um item de dados para uma instância de provedor. Esse valor corresponde ao valor WmiDataId especificado no arquivo MOF do provedor.

[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.

Valor retornado

A função de retorno de chamada EvtWmiInstanceSetItem 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 a FALSE. Se o buffer de entrada ao 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 EvtWmiInstanceSetItem , 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 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 os dados da função de retorno de chamada EvtWmiInstanceSetItem forem dinâmicos e compartilhados com outras funções de retorno de chamada, o driver poderá usar os bloqueios de espera ou os 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 EvtWmiInstanceSetItem , consulte Suporte à WMI em drivers de Framework-Based.

Requisitos

   
Plataforma de Destino Universal
Versão mínima do KMDF 1,0
Cabeçalho wdfwmi.h (inclua Wdf.h)
IRQL PASSIVE_LEVEL

Confira também

EvtWmiInstanceExecuteMethod

EvtWmiInstanceQueryInstance

EvtWmiInstanceSetInstance

EvtWmiProviderFunctionControl

WDF_WMI_INSTANCE_CONFIG

WdfWmiInstanceCreate