Partilhar via

Cabeçalho hwnclx.h

Esse cabeçalho define as interfaces de programação necessárias para fornecer suporte independente de hardware a 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 funcionalidade para uma determinada classe de dispositivos, semelhante a um driver de porta no WDM (Modelo de Driver do Windows). 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 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 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 informações de status.
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 cliente para recuperar atributos de componente de notificação de hardware.
HWN_CLIENT_SET_STATE

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.
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 diferencia o componente de notificação de hardware.

Estruturas

 
CLIENT_DEVICE_INFORMATION

A estrutura de 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 do 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.
  • Last updated on