HWN_CLIENT_SET_STATE função de retorno de chamada (hwnclx.h)
Implementado pelo driver do 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 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.
[in] Buffer
Buffer de bytes BufferLength que contém uma estrutura HWN_HEADER , incluindo uma ou mais estruturas 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.
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.
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 |