Macro WdfDeviceResumeIdleWithTag (wdfdevice.h)

  • Articolo

[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

WdfDeviceResumeIdle

WdfDeviceStopIdle

WdfDeviceStopIdleWithTag