Función WdfUsbTargetDeviceCyclePortSynchronously (wdfusb.h)

  • Artículo

[Solo se aplica a KMDF]

El método WdfUsbTargetDeviceCyclePortSynchronously alimenta el puerto USB al que está conectado un dispositivo especificado.

Sintaxis

NTSTATUS WdfUsbTargetDeviceCyclePortSynchronously(
  [in] WDFUSBDEVICE UsbDevice
);

Parámetros

[in] UsbDevice

Identificador de un objeto de dispositivo USB obtenido de una llamada anterior a WdfUsbTargetDeviceCreateWithParameters.

Valor devuelto

WdfUsbTargetDeviceCyclePortSynchronousmente devuelve el valor de estado de finalización del destino de E/S si la operación se realiza correctamente. De lo contrario, este método podría devolver uno de los siguientes valores:

Código devuelto Descripción
STATUS_INVALID_DEVICE_REQUEST
 IrQL del autor de la llamada no era válido.
 

Este método también 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

El ciclo de alimentación de un puerto hace que el dispositivo se quite y vuelva a enumerar. Un controlador puede solicitar un ciclo de alimentación después de cargar el firmware en un dispositivo.

Antes de que el marco de trabajo ciclos el puerto USB del destino de E/S, cancela todas las solicitudes de E/S que permanecen en la cola del destino de E/S. El controlador no debe enviar solicitudes de E/S adicionales al destino de E/S hasta que WdfUsbTargetDeviceCyclePortSynchronously devuelva.

El controlador debe llamar a WdfIoTargetStop antes de llamar a WdfUsbTargetDeviceCyclePortSynchronously.

Para obtener más información sobre el método WdfUsbTargetDeviceCyclePortSynchronously y los destinos de E/S USB, consulte Destinos de E/S USB.

Ejemplos

En el ejemplo de código siguiente se genera un ciclo de alimentación del puerto USB de un dispositivo especificado.

NTSTATUS status;

status = WdfUsbTargetDeviceCyclePortSynchronously(UsbDevice);

Requisitos

Requisito Value
Plataforma de destino Universal
Versión mínima de KMDF 1.0
Encabezado wdfusb.h (incluya Wdfusb.h)
Library Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos).
IRQL PASSIVE_LEVEL
Reglas de cumplimiento de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Consulte también

WdfUsbTargetDeviceCreateWithParameters