HWN_CLIENT_GET_STATE funzione di callback (hwnclx.h)

Articolo
02/07/2025

Implementato dal driver client per ottenere lo stato del componente di notifica hardware. Viene richiamato quando un utente richiede informazioni sullo stato.

Sintassi

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
)
{...}

Parametri

[in] Context

Puntatore alle informazioni di contesto del driver client. Questo spazio di memoria è disponibile per l'uso da parte del driver client. Viene allocata come parte dello spazio del contesto dell'oggetto framework WdfDeviceCreate. Per altre informazioni, vedere HWN_CLIENT_REGISTRATION_PACKET e Framework Object Context Space.

[out] OutputBuffer

Buffer di OutputBufferLength byte per la scrittura dello stato di notifica hardware. Se la funzione ha esito positivo, il buffer conterrà una struttura HWN_HEADER che include una o più strutture HWN_SETTINGS.

nota

outputBufferLength deve essere sufficientemente grande da contenere tutte le impostazioni richieste. Per altre informazioni, vedere Osservazioni.

[in] OutputBufferLength

Dimensioni di OutputBuffer in byte.

[in] InputBuffer

Buffer di InputBufferLength byte contenenti un HWN_HEADER che contiene una o più strutture HWN_SETTINGS in cui gli ID per i componenti di notifica hardware richiesti vengono archiviati nel campo HwNId. Questo buffer può essere NULL.

[in] InputBufferLength

Dimensioni di InputBuffer in byte.

[out] BytesRead

Puntatore a una variabile che indica il numero di byte letti dalla funzione.

Valore restituito

Restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, restituire un NTSTATUS codice di errore appropriato.

Osservazioni

Registrare l'implementazione di questa funzione di callback impostando il membro appropriato di HWN_CLIENT_REGISTRATION_PACKET e quindi chiamando HwNRegisterClient.

Se InputBuffer è NULL, il buffer di output verrà usato per archiviare una struttura HWN_HEADER che contiene tutte le impostazioni per le notifiche hardware implementate dal driver.
Le impostazioni per un componente di notifica hardware vengono archiviate in una struttura HWN_SETTINGS. Il campo HwNSettingsInfo della struttura HWN_HEADER contiene una matrice di strutture HWN_SETTINGS.
Se InputBuffer non è Null ed è formattato correttamente, conterrà una HWN_HEADER con una o più strutture HWN_SETTINGS. Gli ID per i componenti di notifica hardware richiesti vengono archiviati nel campo HwNId della struttura HWN_SETTINGS. Le impostazioni rimanenti devono essere impostazioni valide o zero.
Se OutputBuffer non è sufficientemente grande da contenere tutte le impostazioni richieste, questa funzione non deve scrivere nulla in OutputBuffer. Inoltre, deve impostare ByteRead su 0 e restituire un errore.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10, versione 1709
server minimo supportato	Windows Server 2016
piattaforma di destinazione	Finestre
intestazione	hwnclx.h
IRQL	PASSIVE_LEVEL

Vedere anche

Le notifiche hardware supportano

informazioni di riferimento sulle notifiche hardware

Condividi tramite