Cabeçalho hwnclx.h

Esse cabeçalho define as interfaces de programação necessárias para fornecer suporte independente de hardware de componentes de notificação, como LEDs e mecanismos de vibração. Esse suporte é fornecido por meio da introdução de uma extensão de classe KMDF (Kernel-Mode Driver Framework) especificamente para componentes de notificação de hardware que permitem o desenvolvimento rápido de drivers de cliente. Uma extensão de classe KMDF é essencialmente um driver KMDF que fornece um conjunto definido de funcionalidades para uma determinada classe de dispositivos, semelhante a um driver de porta no Modelo de Driver do Windows (WDM). Esta seção fornece uma visão geral da arquitetura da extensão da classe de notificação de hardware. Para obter informações adicionais sobre o KMDF, consulte

Para obter mais informações, consulte:

• Guia de design de notificações de hardware

hwnclx.h contém as seguintes interfaces de programação:

Funções

HwNProcessAddDevicePostDeviceCreate Cria filas de E/S. Ele deve ser chamado depois que a função de retorno de chamada EVT_WDF_DRIVER_DEVICE_ADD do driver do cliente for invocada e o objeto do dispositivo tiver sido criado.
HwNProcessAddDevicePreDeviceCreate Fornece os retornos de chamada de preparação/lançamento e entrada/saída do dispositivo para o WDF (Windows Driver Foundation) para fazer a transição do dispositivo para estados diferentes.
HwNRegisterClient Registra o driver do cliente de notificação de hardware e suas funções de retorno de chamada com a extensão de classe.
HwNUnregisterClient Cancela o registro do driver do cliente de notificação de hardware e suas funções de retorno de chamada com a extensão de classe. Essa função deve ser invocada quando o driver cliente é descarregado.

Funções de retorno de chamada

HWN_CLIENT_GET_STATE 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.
HWN_CLIENT_INITIALIZE_DEVICE Implementado pelo driver cliente e é invocado como resultado de uma chamada para EVT_WDF_DEVICE_PREPARE_HARDWARE.
HWN_CLIENT_QUERY_DEVICE_INFORMATION Implementado pelo driver do cliente para recuperar atributos de componente de notificação de hardware.
HWN_CLIENT_SET_STATE 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.
HWN_CLIENT_START_DEVICE Implementado pelo driver cliente para iniciar o componente de notificação de hardware. Ele é invocado como resultado de uma chamada para EVT_WDF_DEVICE_D0_ENTRY.
HWN_CLIENT_STOP_DEVICE Implementado pelo driver cliente para iniciar o componente de notificação de hardware. Ele é invocado como resultado de uma chamada para EVT_WDF_DEVICE_D0_EXIT.
HWN_CLIENT_UNINITIALIZE_DEVICE Implementado pelo driver cliente e invocado como invocado como resultado de uma chamada para EVT_WDF_DEVICE_RELEASE_HARDWARE. Essa função de retorno de chamada não inicializa o componente de notificação de hardware.

Estruturas

CLIENT_DEVICE_INFORMATION A estrutura CLIENT_DEVICE_INFORMATION é usada pelo retorno de chamada de notificação de hardware HWN_CLIENT_QUERY_DEVICE_INFORMATION para retornar o número total de notificações de hardware fornecidas pelo driver de dispositivo cliente.
HWN_CLIENT_REGISTRATION_PACKET Pacote de registro do driver do cliente de Notificação de Hardware que é passado para a extensão de classe quando um driver cliente é registrado. Contém informações de versão e funções de retorno de chamada do driver de cliente.

Enumerações

HWN_CLX_EXPORT_INDEX Define a posição para cada uma das exportações de Notificação de Hardware na tabela de exportação.