HWN_CLIENT_INITIALIZE_DEVICE Rückruffunktion (hwnclx.h)

Artikel
02/29/2024

Wird vom Clienttreiber implementiert und als Ergebnis eines Aufrufs von EVT_WDF_DEVICE_PREPARE_HARDWARE aufgerufen.

Syntax

HWN_CLIENT_INITIALIZE_DEVICE HwnClientInitializeDevice;

NTSTATUS HwnClientInitializeDevice(
  [in] WDFDEVICE Device,
  [in] PVOID Context,
  [in] WDFCMRESLIST ResourcesRaw,
  [in] WDFCMRESLIST ResourcesTranslated
)
{...}

Parameter

[in] Device

Handle mit dem Clienttreiberframework-Geräteobjekt.

[in] Context

Zeiger auf die Kontextinformationen des Clienttreibers. Dieser Speicherplatz steht für die Verwendung durch den Clienttreiber zur Verfügung. Sie wird von WdfDeviceCreate als Teil des Kontextraums des Frameworkobjekts zugeordnet. Weitere Informationen finden Sie unter HWN_CLIENT_REGISTRATION_PACKET - und Framework-Objektkontextbereich.

[in] ResourcesRaw

Handle mit einem Framework-Ressourcenlistenobjekt, das die rohen Hardwareressourcen identifiziert, die der Plug & Play-Manager dem Gerät zugewiesen hat.

[in] ResourcesTranslated

Handle mit einem Framework-Ressourcenlistenobjekt, das die übersetzten Hardwareressourcen identifiziert, die der Plug & Play-Manager dem Gerät zugewiesen hat.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls wird ein entsprechender NTSTATUS-Fehlercode zurückgegeben.

Hinweise

Registrieren Sie Ihre Implementierung dieser Rückruffunktion, indem Sie den entsprechenden Member von HWN_CLIENT_REGISTRATION_PACKET festlegen und dann HwNRegisterClient aufrufen.

Anforderungen

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

Weitere Informationen

Unterstützung von Hardwarebenachrichtigungen

Referenz zu Hardwarebenachrichtigungen

Share via