Función WdfUsbTargetDeviceIsConnectedSynchronous (wdfusb.h)

  • Artículo

[Solo se aplica a KMDF]

El método WdfUsbTargetDeviceIsConnectedSynchronous determina si el dispositivo USB especificado está conectado.

Sintaxis

NTSTATUS WdfUsbTargetDeviceIsConnectedSynchronous(
  [in] WDFUSBDEVICE UsbDevice
);

Parámetros

[in] UsbDevice

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

Valor devuelto

WdfUsbTargetDeviceIsConnectedSynchronous 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 puede devolver uno de los valores siguientes:

Código devuelto Descripción
STATUS_INVALID_PARAMETER
 Se ha detectado un parámetro no válido.
STATUS_INVALID_DEVICE_REQUEST
 IrQL del autor de la llamada no era válido.
STATUS_DEVICE_NOT_CONNECTED o STATUS_DEVICE_DOES_NOT_EXIST
 El dispositivo no estaba conectado.
 

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

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

Ejemplos

En el ejemplo de código siguiente se determina si un dispositivo USB especificado está conectado.

NTSTATUS status;

status = WdfUsbTargetDeviceIsConnectedSynchronous(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