Macro WdfDeviceStopIdleWithTag (wdfdevice.h)
[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