Macro WdfDeviceResumeIdleWithTag (wdfdevice.h)

  • Artículo

[Se aplica a KMDF y UMDF]

La macro WdfDeviceResumeIdleWithTag disminuye el recuento de referencias de energía de un objeto de dispositivo de marco especificado y asigna el nombre de archivo actual del controlador y el número de línea a la referencia. La macro también asigna un valor de etiqueta a la referencia.

Sintaxis

void WdfDeviceResumeIdleWithTag(
  [in]  Device,
  [in]  Tag
);

Parámetros

[in] Device

Identificador de un objeto de dispositivo de marco.

[in] Tag

Valor definido por el controlador que el marco almacena como una etiqueta de identificación para la referencia de energía.

Valor devuelto

None

Observaciones

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

Si el recuento de referencias del objeto se convierte en cero, es posible que el objeto se elimine antes de que se devuelva WdfDeviceResumeIdleWithTag .

Llamar a WdfDeviceResumeIdleWithTag en lugar de WdfDeviceResumeIdle proporciona información adicional (valor de etiqueta, número de línea y nombre de archivo) que puede ver en los depuradores de Microsoft. WdfDeviceResumeIdleWithTag usa el número de línea actual del controlador y el nombre de archivo.

Puede ver los valores de etiqueta, número de línea y nombre de archivo mediante la extensión del depurador !wdfkd.wdftagtracker .

Use !wdfkd.wdfdevice con marcas detalladas en y busque el vínculo a !wdftagtracker en la salida:

kd> !wdfdevice <handle> f

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.15
Versión mínima de UMDF 2.15
Encabezado wdfdevice.h (incluir Wdf.h)
Library Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <= DISPATCH_LEVEL
Reglas de cumplimiento de DDI DriverCreate, KmdfIrql, KmdfIrql2

Consulte también

Depuración de fugas de referencia de energía en WDF

WdfDeviceResumeIdle

WdfDeviceStopIdle

WdfDeviceStopIdleWithTag