Macro WdfDeviceStopIdleWithTag (wdfdevice.h)

  • Articolo

[Si applica a KMDF e UMDF]

La macro WdfDeviceStopIdleWithTag incrementa il conteggio dei riferimenti di potenza per un oggetto dispositivo framework specificato e assegna il nome del file corrente e il numero di riga del driver al riferimento. La macro assegna inoltre un valore di tag al riferimento.

Sintassi

NTSTATUS WdfDeviceStopIdleWithTag(
    _In_ WDFDEVICE Device,
    _In_ BOOLEAN WaitForD0,
    _In_ PVOID Tag
);

Parametri

[in] Device

Handle per un oggetto dispositivo framework.

[in] WaitForD0

Valore booleano che indica quando verrà restituito WdfDeviceStopIdleWithTag . Se TRUE, restituisce solo dopo che il dispositivo specificato ha immesso lo stato di alimentazione del dispositivo D0. Se FALSE, il metodo restituisce immediatamente.

[in] Tag

Valore definito dal driver archiviato dal framework come tag di identificazione per il riferimento alla potenza.

Valore restituito

nessuno

Osservazioni

Se l'operazione ha esito positivo, WdfDeviceStopIdleWithTag restituisce STATUS_SUCCESS.

I valori restituiti aggiuntivi includono:

Codice restituito Descrizione
STATUS_PENDING

Il dispositivo viene acceso in modo asincrono.
STATUS_INVALID_DEVICE_STATE

Il driver non è il proprietario dei criteri di alimentazione per il dispositivo.
STATUS_POWER_STATE_INVALID

Si è verificato un errore del dispositivo e il dispositivo non può entrare nello stato di alimentazione D0.

Il metodo potrebbe restituire altri valori NTSTATUS.

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

Se il driver chiama WdfDeviceStopIdleWithTag per incrementare un conteggio dei riferimenti, il driver deve chiamare WdfDeviceResumeIdleWithTag per decrementare il conteggio.

La chiamata a WdfDeviceStopIdleWithTag anziché WdfDeviceStopIdle fornisce informazioni aggiuntive (valore del tag, numero di riga e nome file) che è possibile visualizzare nei debugger Microsoft. WdfDeviceStopIdleWithTag usa il numero di riga e il nome file correnti del driver.

È possibile visualizzare i valori di tag, numero di riga e nome file usando l'estensione del debugger !wdftagtracker . L'estensione del debugger visualizza il valore del tag sia come puntatore che come serie di caratteri.

Usare !wdfkd.wdfdevice con flag verbose on e individuare il collegamento a !wdftagtracker nell'output:

kd> !wdfdevice <handle> f

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.15
Versione UMDF minima 2.15
Intestazione wdfdevice.h (include Wdf.h)
Libreria Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL Vedere la sezione Osservazioni.
Regole di conformità DDI DriverCreate, KmdfIrql, KmdfIrql2

Vedi anche

Debug delle perdite di riferimento per l'alimentazione in WDF

WdfDeviceResumeIdle

WdfDeviceResumeIdleWithTag

WdfDeviceStopIdle