Función WdfUsbTargetDeviceIsConnectedSynchronous (wdfusb.h)

[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