Compartilhar via

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

  • Artigo

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

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 do 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 de estrutura por WdfDeviceCreate. Para obter mais informações, consulte HWN_CLIENT_REGISTRATION_PACKET e Espaço de Contexto do Objeto framework.

[out] OutputBuffer

Buffer de bytes OutputBufferLength para gravar 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 .

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 bytes InputBufferLength que contêm um HWN_HEADER mantendo 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.

Retornar valor

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

Comentários

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

  • Se InputBuffer for NULL, o buffer de saída será usado para armazenar uma estrutura HWN_HEADER que contém 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 estiver 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
Cliente mínimo com suporte Windows 10, versão 1709
Servidor mínimo com suporte Windows Server 2016
Plataforma de Destino Windows
Cabeçalho hwnclx.h
IRQL PASSIVE_LEVEL

Confira também

Suporte a notificações de hardware

Referência de notificações de hardware