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 do 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 que InBuffer aponta.
[in] InBuffer
Um ponteiro para o buffer de entrada.
Valor de retorno
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 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 EvtWmiInstanceSetItem, 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 EvtWmiInstanceSetItem 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 EvtWmiInstanceSetItem, 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 |