HWN_CLIENT_SET_STATE Rückruffunktion (hwnclx.h)
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 |