HWN_CLIENT_GET_STATE função de retorno de chamada (hwnclx.h)

Artigo
02/07/2025

Implementado pelo driver cliente para obter o estado do componente de notificação de hardware. Ele é invocado quando um usuário solicita informações de status.

Sintaxe

HWN_CLIENT_GET_STATE HwnClientGetState;

NTSTATUS HwnClientGetState(
  [in]  PVOID Context,
  [out] PVOID OutputBuffer,
  [in]  ULONG OutputBufferLength,
  [in]  PVOID InputBuffer,
  [in]  ULONG InputBufferLength,
  [out] PULONG BytesRead
)
{...}

Parâmetros

[in] Context

Ponteiro para as informações de contexto do driver cliente. Esse espaço de memória está disponível para uso pelo driver cliente. Ele é alocado como parte do espaço de contexto do objeto da estrutura WdfDeviceCreate. Para obter mais informações, consulte HWN_CLIENT_REGISTRATION_PACKET e Framework Object Context Space.

[out] OutputBuffer

Buffer de OutputBufferLength bytes para gravar o status de notificação de hardware. Se a função for bem-sucedida, o buffer conterá uma estrutura HWN_HEADER, incluindo uma ou mais estruturas HWN_SETTINGS.

de Observação

OutputBufferLength deve ser grande o suficiente para conter todas as configurações solicitadas. Para obter mais informações, consulte Comentários.

[in] OutputBufferLength

O tamanho de OutputBuffer em bytes.

[in] InputBuffer

Buffer de InputBufferLength bytes que contêm um HWN_HEADER que contém uma ou mais estruturas HWN_SETTINGS em que as IDs dos componentes de notificação de hardware solicitados são armazenadas no campo HwNId. Esse buffer pode ser NULL.

[in] InputBufferLength

O tamanho de InputBuffer em bytes.

[out] BytesRead

Ponteiro para uma variável que indica o número de bytes lidos pela função.

Valor de retorno

Retorne STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, retorne um código de erro NTSTATUS apropriado.

Observações

Registre sua implementação dessa função de retorno de chamada definindo o membro apropriado do HWN_CLIENT_REGISTRATION_PACKET e, em seguida, chamando HwNRegisterClient.

Se InputBuffer for NULL, o buffer de saída será usado para armazenar uma estrutura de HWN_HEADER que contenha todas as configurações para as notificações de hardware implementadas pelo driver.
As configurações de um componente de notificação de hardware são armazenadas em uma estrutura HWN_SETTINGS. O campo HwNSettingsInfo da estrutura HWN_HEADER contém uma matriz de estruturas HWN_SETTINGS.
Se inputbuffer não for nulo e for formatado corretamente, ele conterá um HWN_HEADER com uma ou mais estruturas HWN_SETTINGS. As IDs dos componentes de notificação de hardware solicitados são armazenadas no campo HwNId da estrutura HWN_SETTINGS. As configurações restantes devem ser configurações válidas ou zero.
Se OutputBuffer não for grande o suficiente para conter todas as configurações solicitadas, essa função não deverá gravar nada no OutputBuffer. Além disso, ele deve definir BytesRead como 0 e retornar um erro.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10, versão 1709
servidor com suporte mínimo	Windows Server 2016
da Plataforma de Destino	Windows
cabeçalho	hwnclx.h
IRQL	PASSIVE_LEVEL

Consulte também

suporte a notificações de hardware

referência de notificações de hardware

Compartilhar via