Función WdfDeviceIndicateWakeStatus (wdfdevice.h)

  • Artículo

[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 sección Comentarios que se muestra más adelante.

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 se 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.

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

Comentarios

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 reactivación del sistema.

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 Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Encabezado wdfdevice.h (incluya Wdf.h)
Library 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)