Funzione WdfDeviceIndicateWakeStatus (wdfdevice.h)

Articolo
02/27/2024

[Si applica solo a KMDF]

Il metodo WdfDeviceIndicateWakeStatus informa il framework che il driver del bus chiamante ha smesso di attendere che un dispositivo specificato attivi un segnale di riattivazione sul bus.

Sintassi

NTSTATUS WdfDeviceIndicateWakeStatus(
  [in] WDFDEVICE Device,
  [in] NTSTATUS  WaitWakeStatus
);

Parametri

[in] Device

Handle per un oggetto dispositivo framework.

[in] WaitWakeStatus

Valore di stato NTSTATUS. Se il dispositivo ha attivato un segnale di riattivazione, il chiamante deve impostare questo valore su STATUS_SUCCESS o un altro valore di stato per il quale NT_SUCCESS(WaitWakeStatus) è uguale a TRUE. Se il dispositivo non ha attivato un segnale di riattivazione o se è stato rilevato un errore, il chiamante deve fornire un valore di stato per il quale NT_SUCCESS(WaitWakeStatus) è false. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

Valore restituito

Se l'operazione ha esito positivo, WdfDeviceIndicateWakeStatus restituisce STATUS_SUCCESS. I valori restituiti aggiuntivi includono:

Codice restituito	Descrizione
STATUS_INVALID_PARAMETER	WaitWakeStatus è STATUS_PENDING o STATUS_CANCELLED.
STATUS_INVALID_DEVICE_REQUEST	Lo stack di driver non è stato configurato per attendere che il dispositivo attivi un segnale di riattivazione.
STATUS_INVALID_DEVICE_STATE	Il driver chiamante non è responsabile dell'attesa che il dispositivo attivi un segnale di riattivazione.

Il metodo potrebbe restituire altri valori NTSTATUS.

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

Commenti

Se NT_SUCCESS(WaitWakeStatus) è uguale a TRUE, il framework ripristina il dispositivo e il sistema ai relativi stati di lavoro. Se NT_SUCCESS(WaitWakeStatus) è uguale a FALSE, il dispositivo e il sistema rimarranno negli stati correnti.

Per altre informazioni sulla chiamata al metodo WdfDeviceIndicateWakeStatus , vedere Supporto della riattivazione del sistema.

Esempio

Nell'esempio di codice seguente viene indicato al framework che il dispositivo specificato ha attivato un segnale di riattivazione.

NTSTATUS  status;

status = WdfDeviceIndicateWakeStatus(
                                     hChild,
                                     STATUS_SUCCESS
                                     );

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.0
Intestazione	wdfdevice.h (include Wdf.h)
Libreria	Wdf01000.sys (vedere Controllo delle versioni della libreria framework).
IRQL	<= DISPATCH_LEVEL
Regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Condividi tramite