Función WdfUsbTargetDeviceCyclePortSynchronously (wdfusb.h)
[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 |
|---|---|
|
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) |