HWN_CLIENT_SET_STATE Rückruffunktion (hwnclx.h)

Artikel
02/26/2024

Wird vom Clienttreiber implementiert, um den Zustand der Hardwarebenachrichtigungskomponente festzulegen. Sie wird aufgerufen, wenn ein Benutzer den Zustand eines Treibers ändern möchte.

Syntax

HWN_CLIENT_SET_STATE HwnClientSetState;

NTSTATUS HwnClientSetState(
  [in]  PVOID Context,
  [in]  PVOID Buffer,
  [in]  ULONG BufferLength,
  [out] PULONG BytesWritten
)
{...}

Parameter

[in] Context

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

[in] Buffer

Puffer von BufferLength-Bytes , die eine HWN_HEADER-Struktur einschließlich einer oder mehrerer HWN_SETTINGS-Strukturen enthalten, die die festzulegenden Hardwarebenachrichtigungen angeben.

[in] BufferLength

Die Größe des Puffers in Bytes.

[out] BytesWritten

Zeiger auf eine Variable, die die Anzahl der von der Funktion geschriebenen Bytes angibt.

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