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

Artigo
07/02/2025

Implementado pelo driver cliente para definir o estado do componente de notificação de hardware. Ele é invocado quando um usuário deseja alterar o estado de um driver.

Sintaxe

HWN_CLIENT_SET_STATE HwnClientSetState;

NTSTATUS HwnClientSetState(
  [in]  PVOID Context,
  [in]  PVOID Buffer,
  [in]  ULONG BufferLength,
  [out] PULONG BytesWritten
)
{...}

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.

[in] Buffer

Buffer de BufferLength bytes que contêm uma estrutura de HWN_HEADER, incluindo uma ou mais estruturas de HWN_SETTINGS que especificam as notificações de hardware a serem definidas.

[in] BufferLength

O tamanho do buffer em bytes.

[out] BytesWritten

Ponteiro para uma variável que indica o número de bytes gravados 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.

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