HwNRegisterClient-Funktion (hwnclx.h)

Registriert den Hardwarebenachrichtigungsclienttreiber und die zugehörigen Rückruffunktionen bei der Klassenerweiterung. Diese Funktion sollte aufgerufen werden, wenn der Clienttreiber geladen wird und die DriverEntry-Routine zur Initialisierung aufgerufen wird.

Syntax

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

Parameter

[in] Driver

Handle mit dem Framework-Treiberobjekt des Clienttreibers.

[in, out] RegistrationPacket

Zeiger auf die HWN_CLIENT_REGISTRATION_PACKET Struktur, die Funktionszeiger auf die Rückruffunktionen enthält, die in der Clienttreiberimplementierung definiert und von der Klassenerweiterung benötigt werden.

[in] RegistryPath

Zeiger auf eine UNICODE_STRING Struktur, die den Pfad zum Registrierungsschlüssel des Clienttreibers enthält.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn die Funktion erfolgreich ist. Gibt STATUS_INVALID_PARAMETER zurück, wenn der entsprechende Clienttreiber nicht gefunden werden kann. Andernfalls wird einer der in Ntstatus.h definierten Fehlerwerte status zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1709
Unterstützte Mindestversion (Server)	Windows Server 2016
Zielplattform	Windows
Kopfzeile	hwnclx.h
Bibliothek	Mshwnclxstub.lib
IRQL	PASSIVE_LEVEL

Weitere Informationen

Unterstützung von Hardwarebenachrichtigungen

Referenz zu Hardwarebenachrichtigungen