Función WdfUsbTargetDeviceResetPortSynchronously (wdfusb.h)
[Se aplica a KMDF y UMDF]
El método WdfUsbTargetDeviceResetPortSynchronously restablece el puerto USB asociado al dispositivo USB especificado.
Sintaxis
NTSTATUS WdfUsbTargetDeviceResetPortSynchronously(
[in] WDFUSBDEVICE UsbDevice
);
Parámetros
[in] UsbDevice
Identificador de un objeto de dispositivo USB obtenido de una llamada anterior a WdfUsbTargetDeviceCreateWithParameters.
Valor devuelto
WdfUsbTargetDeviceResetPortSynchronously devuelve el valor de estado de finalización del destino de E/S USB si la operación se realiza correctamente. De lo contrario, este método puede 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 puede devolver otros valores de NTSTATUS.
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
Observaciones
El método WdfUsbTargetDeviceResetPortSynchronously restablece el puerto USB mediante el envío de una solicitud de IOCTL_INTERNAL_USB_RESET_PORT.
Antes de que el marco restablezca 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 WdfUsbTargetDeviceResetPortSynchronously devuelve.
El controlador debe llamar a WdfIoTargetStop antes de llamar a WdfUsbTargetDeviceResetPortSynchronously. Después de devuelve WdfUsbTargetDeviceResetPortSynchronously, el controlador puede llamar a WdfIoTargetStart.
Después de una operación de restablecimiento correcta, el controlador de bus vuelve a seleccionar la configuración y cualquier configuración de interfaz alternativa que el dispositivo tenía antes de que se produjera la operación de restablecimiento.
Para obtener más información sobre el método WdfUsbTargetDeviceResetPortSynchronously y los destinos de E/S USB, consulte destinos de E/S USB.
Ejemplos
En el ejemplo de código siguiente se restablece el puerto USB de un dispositivo especificado.
NTSTATUS status;
status = WdfUsbTargetDeviceResetPortSynchronously(UsbDevice);
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| versión mínima de UMDF | 2.0 |
| encabezado de | wdfusb.h (incluya Wdfusb.h) |
| biblioteca de | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| irQL | PASSIVE_LEVEL |
| reglas de cumplimiento de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf) |