Condividi tramite


Macro WdfDeviceResumeIdleWithTag (wdfdevice.h)

[Si applica a KMDF e UMDF]

Il WdfDeviceResumeIdleWithTag macro decrementa il conteggio dei riferimenti di alimentazione 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 all'alimentazione.

Valore restituito

Nessuno

Osservazioni

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

Se il numero di riferimenti dell'oggetto diventa zero, l'oggetto potrebbe essere eliminato prima di restituisce WdfDeviceResumeIdleWithTag.

Chiamando WdfDeviceResumeIdleWithTag invece di 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.wdftagtrack er.

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

kd> !wdfdevice <handle> f 

Fabbisogno

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

Vedere anche

debug delle perdite di riferimenti all'alimentazione in WDF

WdfDeviceResumeIdle

WdfDeviceStopIdle

WdfDeviceStopIdleWithTag