HWN_CLIENT_GET_STATE Rückruffunktion (hwnclx.h)

Vom Clienttreiber implementiert, um den Hardwarebenachrichtigungskomponentenstatus abzurufen. Er wird aufgerufen, wenn ein Benutzer Statusinformationen anfordert.

Syntax

HWN_CLIENT_GET_STATE HwnClientGetState;

NTSTATUS HwnClientGetState(
  [in]  PVOID Context,
  [out] PVOID OutputBuffer,
  [in]  ULONG OutputBufferLength,
  [in]  PVOID InputBuffer,
  [in]  ULONG InputBufferLength,
  [out] PULONG BytesRead
)
{...}

Parameter

[in] Context

Zeigen Sie auf die Kontextinformationen des Clienttreibers. Dieser Speicherplatz steht für die Verwendung durch den Clienttreiber zur Verfügung. Sie wird als Teil des Frameworkobjektkontextbereichs durch WdfDeviceCreatezugewiesen. Weitere Informationen finden Sie unter HWN_CLIENT_REGISTRATION_PACKET und Framework Object Context Space.

[out] OutputBuffer

Puffer von OutputBufferLength Bytes zum Schreiben des Hardwarebenachrichtigungsstatus. Wenn die Funktion erfolgreich ist, enthält der Puffer eine HWN_HEADER Struktur, einschließlich einer oder mehrerer HWN_SETTINGS Strukturen.

  

OutputBufferLength- muss groß genug sein, um alle angeforderten Einstellungen zu enthalten. Weitere Informationen finden Sie in den Hinweisen.

 

[in] OutputBufferLength

Die Größe OutputBuffer- in Byte.

[in] InputBuffer

Puffer von InputBufferLength- Bytes, die eine HWN_HEADER enthalten, die mindestens eine HWN_SETTINGS Strukturen enthalten, in denen die IDs für die angeforderten Hardwarebenachrichtigungskomponenten im HwNId- Feld gespeichert werden. Dieser Puffer kann NULL sein.

[in] InputBufferLength

Die Größe InputBuffer- in Byte.

[out] BytesRead

Zeigen Sie auf eine Variable, die die Anzahl der von der Funktion gelesenen Bytes angibt.

Rückgabewert

Gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Geben Sie andernfalls einen geeigneten NTSTATUS- Fehlercode zurück.

Bemerkungen

Registrieren Sie die Implementierung dieser Rückruffunktion, indem Sie das entsprechende Element von HWN_CLIENT_REGISTRATION_PACKET festlegen und dann HwNRegisterClientaufrufen.

• Wenn InputBuffer- NULL ist, wird der Ausgabepuffer verwendet, um eine HWN_HEADER Struktur zu speichern, die alle Einstellungen für die vom Treiber implementierten Hardwarebenachrichtigungen enthält.

  Die Einstellungen für eine Hardwarebenachrichtigungskomponente werden in einer HWN_SETTINGS Struktur gespeichert. Das HwNSettingsInfo Feld der HWN_HEADER Struktur enthält ein Array von HWN_SETTINGS Strukturen.

• Wenn InputBuffer- nicht null ist und richtig formatiert ist, enthält es eine HWN_HEADER mit mindestens einem HWN_SETTINGS Strukturen. Die IDs für die angeforderten Hardwarebenachrichtigungskomponenten werden im HwNId Feld der HWN_SETTINGS Struktur gespeichert. Die verbleibenden Einstellungen sollten gültige Einstellungen oder Null sein.
• Wenn OutputBuffer- nicht groß genug ist, um alle angeforderten Einstellungen zu enthalten, sollte diese Funktion nichts in OutputBuffer-schreiben. Darüber hinaus sollte BytesRead- auf 0 festgelegt und ein Fehler zurückgegeben werden.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10, Version 1709
mindestens unterstützte Server-	Windows Server 2016
Zielplattform-	Fenster
Header-	hwnclx.h
IRQL-	PASSIVE_LEVEL

Siehe auch

Hardwarebenachrichtigungen unterstützen

referenz Hardwarebenachrichtigungen