Macro WdfDeviceStopIdleWithTag (wdfdevice.h)
[Se aplica a KMDF y UMDF]
La macro WdfDeviceStopIdleWithTag incrementa 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
NTSTATUS WdfDeviceStopIdleWithTag(
_In_ WDFDEVICE Device,
_In_ BOOLEAN WaitForD0,
_In_ PVOID Tag
);
Parámetros
[in] Device
Identificador de un objeto de dispositivo de marco.
[in] WaitForD0
Valor booleano que indica cuándo devolverá WdfDeviceStopIdleWithTag . Si es TRUE, devuelve solo después de que el dispositivo especificado haya entrado en el estado de alimentación del dispositivo D0. Si es FALSE, el método devuelve inmediatamente.
[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
Si la operación se realiza correctamente, WdfDeviceStopIdleWithTag devuelve STATUS_SUCCESS.
Entre los valores devueltos adicionales se incluyen:
| Código devuelto | Descripción |
|---|---|
| STATUS_PENDING | El dispositivo se está alimentando de forma asincrónica. |
| STATUS_INVALID_DEVICE_STATE | El controlador no es el propietario de la directiva de energía del dispositivo. |
| STATUS_POWER_STATE_INVALID | Se produjo un error en el dispositivo y el dispositivo no puede entrar en su estado de alimentación D0. |
El método podría devolver otros valores NTSTATUS.
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
Si el controlador llama a WdfDeviceStopIdleWithTag para incrementar un recuento de referencias, el controlador debe llamar a WdfDeviceResumeIdleWithTag para reducir el recuento.
Llamar a WdfDeviceStopIdleWithTag en lugar de WdfDeviceStopIdle proporciona información adicional (valor de etiqueta, número de línea y nombre de archivo) que puede ver en los depuradores de Microsoft. WdfDeviceStopIdleWithTag 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 !wdftagtracker . La extensión del depurador muestra el valor de etiqueta como puntero y una serie de caracteres.
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 | vea la sección Comentarios. |
| Reglas de cumplimiento de DDI | DriverCreate, KmdfIrql, KmdfIrql2 |