Função HwNRegisterClient (hwnclx.h)

Registra o 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 é carregado e a rotina DriverEntry é chamada para inicialização.

Sintaxe

FORCEINLINE NTSTATUS  HwNRegisterClient(
  _In_    WDFDRIVER                        Driver,
  _Inout_ PHWN_CLIENT_REGISTRATION_PACKET  RegistrationPacket,
  _In_    PUNICODE_STRING                  RegistryPath
);

Parâmetros

[in] Driver

Identificador para o objeto de driver da estrutura de drivers de cliente.

[in, out] RegistrationPacket

Ponteiro para a estrutura HWN_CLIENT_REGISTRATION_PACKET que contém ponteiros de função para as funções de retorno de chamada definidas na implementação do driver cliente e exigidas pela extensão de classe.

[in] RegistryPath

Ponteiro para uma estrutura UNICODE_STRING que contém o caminho para a chave do Registro do driver do cliente.

Retornar valor

Retorna STATUS_SUCCESS se a função for bem-sucedida. Retorna STATUS_INVALID_PARAMETER se o driver de cliente correspondente não puder ser encontrado. Caso contrário, ele retornará um dos valores de status de erro definidos em Ntstatus.h.

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
Biblioteca Mshwnclxstub.lib
IRQL PASSIVE_LEVEL

Confira também

Suporte a notificações de hardware

Referência de notificações de hardware