Funzione WdfDeviceIndicateWakeStatus (wdfdevice.h)

Articolo
02/07/2025

[Si applica solo a KMDF]

Il metodo WdfDeviceIndicateWakeStatus informa il framework che l'autista 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 su un altro valore di stato per il quale NT_SUCCESS(WaitWakeStatus) è uguale 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) è uguale FALSE. Per altre informazioni, vedere la sezione Osservazioni seguente.

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 del dispositivo per attivare 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.

Osservazioni

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

Per altre informazioni sulla chiamata al metodo WdfDeviceIndicateWakeStatus, vedere di riattivazione del sistema di supporto.

Esempi

L'esempio di codice seguente informa il framework che il dispositivo specificato ha attivato un segnale di riattivazione.

NTSTATUS  status;

status = WdfDeviceIndicateWakeStatus(
                                     hChild,
                                     STATUS_SUCCESS
                                     );

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	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