Función WdfDeviceIndicateWakeStatus (wdfdevice.h)

Artículo
02/07/2025

[Solo se aplica a KMDF]

El método WdfDeviceIndicateWakeStatus informa al marco de trabajo que el controlador de bus de llamada ha dejado de esperar a que un dispositivo especificado desencadene una señal de reactivación en el bus.

Sintaxis

NTSTATUS WdfDeviceIndicateWakeStatus(
  [in] WDFDEVICE Device,
  [in] NTSTATUS  WaitWakeStatus
);

Parámetros

[in] Device

Identificador de un objeto de dispositivo de marco.

[in] WaitWakeStatus

Valor de estado NTSTATUS. Si el dispositivo desencadenó una señal de reactivación, el autor de la llamada debe establecer este valor en STATUS_SUCCESS u otro valor de estado para el que NT_SUCCESS(WaitWakeStatus) es igual a TRUE. Si el dispositivo no desencadenó una señal de reactivación o si se detectó un error, el autor de la llamada debe proporcionar un valor de estado para el que NT_SUCCESS(WaitWakeStatus) es igual a FALSE. Para obtener más información, vea la siguiente sección Comentarios.

Valor devuelto

Si la operación se realiza correctamente, WdfDeviceIndicateWakeStatus devuelve STATUS_SUCCESS. Entre los valores devueltos adicionales se incluyen:

Código devuelto	Descripción
STATUS_INVALID_PARAMETER	waitWakeStatus es STATUS_PENDING o STATUS_CANCELLED.
STATUS_INVALID_DEVICE_REQUEST	La pila del controlador no se configuró para esperar a que el dispositivo desencadene una señal de reactivación.
STATUS_INVALID_DEVICE_STATE	El controlador de llamada no es responsable de esperar a que el dispositivo desencadene una señal de reactivación.

El método podría devolver otros valores ntstatus de .

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

Observaciones

Si NT_SUCCESS(WaitWakeStatus) es igual a TRUE, el marco restaurará el dispositivo y el sistema a sus estados de trabajo. Si NT_SUCCESS(WaitWakeStatus) es igual a FALSE, el dispositivo y el sistema permanecerán en sus estados actuales.

Para obtener más información sobre cómo llamar al método WdfDeviceIndicateWakeStatus, vea compatibilidad con el sistema de reactivación.

Ejemplos

En el ejemplo de código siguiente se informa al marco de trabajo que el dispositivo especificado ha desencadenado una señal de reactivación.

NTSTATUS  status;

status = WdfDeviceIndicateWakeStatus(
                                     hChild,
                                     STATUS_SUCCESS
                                     );

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
versión mínima de KMDF	1.0
encabezado de	wdfdevice.h (incluya Wdf.h)
biblioteca de	Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos).
irQL	<= DISPATCH_LEVEL
reglas de cumplimiento de DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Compartir a través de