Macro WdfDeviceResumeIdleWithTag (wdfdevice.h)
[Si applica a KMDF e UMDF]
La macro WdfDeviceResumeIdleWithTag decrementa 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
void WdfDeviceResumeIdleWithTag(
[in] Device,
[in] Tag
);
Parametri
[in] Device
Handle per un oggetto dispositivo framework.
[in] Tag
Valore definito dal driver archiviato dal framework come tag di identificazione per il riferimento alla potenza.
Valore restituito
nessuno
Osservazioni
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.
Se il conteggio dei riferimenti dell'oggetto diventa zero, l'oggetto potrebbe essere eliminato prima che WdfDeviceResumeIdleWithTag restituisca.
La chiamata a WdfDeviceResumeIdleWithTag anziché WdfDeviceResumeIdle fornisce informazioni aggiuntive (valore del tag, numero di riga e nome file) che è possibile visualizzare nei debugger Microsoft. WdfDeviceResumeIdleWithTag 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 !wdfkd.wdftagtracker .
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 | <= DISPATCH_LEVEL |
| Regole di conformità DDI | DriverCreate, KmdfIrql, KmdfIrql2 |
Vedi anche
Debug delle perdite di riferimento per l'alimentazione in WDF