Funzione WdfDeviceIndicateWakeStatus (wdfdevice.h)

  • Articolo

[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)