HwNRegisterClient function (hwnclx.h)

Registers the hardware notification client driver and its callback functions with the class extension. This function should be invoked when the client driver is loaded and the DriverEntry routine is called for initialization.

Syntax

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

Parameters

[in] Driver

Handle to the client drivers framework driver object.

[in, out] RegistrationPacket

Pointer to the HWN_CLIENT_REGISTRATION_PACKET structure that contains function pointers to the callback functions defined in the client driver implementation and required by the class extension.

[in] RegistryPath

Pointer to a UNICODE_STRING structure that contains the path to the client driver’s registry key.

Return value

Returns STATUS_SUCCESS if function succeeds. Returns STATUS_INVALID_PARAMETER if corresponding client driver can't be found. Otherwise, it returns one of the error status values defined in Ntstatus.h.

Requirements

Requirement Value
Minimum supported client Windows 10, version 1709
Minimum supported server Windows Server 2016
Target Platform Windows
Header hwnclx.h
Library Mshwnclxstub.lib
IRQL PASSIVE_LEVEL

See also

Hardware notifications support

Hardware notifications reference