nf-wdfusb-wdfusbtargetdeviceisconnectedsynchronous.md

UID	title	description	old-location	tech.root	ms.date	keywords	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	f1_keywords	topic_type	api_type	api_location	api_name
NF:wdfusb.WdfUsbTargetDeviceIsConnectedSynchronous	WdfUsbTargetDeviceIsConnectedSynchronous function (wdfusb.h)	The WdfUsbTargetDeviceIsConnectedSynchronous method determines if the specified USB device is connected.	wdf\wdfusbtargetdeviceisconnectedsynchronous.htm	wdf	02/26/2018	WdfUsbTargetDeviceIsConnectedSynchronous function	DFUsbRef_52c60eb0-7e47-4064-9bb5-f2c7ba2e182a.xml, WdfUsbTargetDeviceIsConnectedSynchronous, WdfUsbTargetDeviceIsConnectedSynchronous method, kmdf.wdfusbtargetdeviceisconnectedsynchronous, wdf.wdfusbtargetdeviceisconnectedsynchronous, wdfusb/WdfUsbTargetDeviceIsConnectedSynchronous	wdfusb.h	Wdfusb.h	Universal			1.0		DriverCreate, KmdfIrql, KmdfIrql2, UsbKmdfIrql, UsbKmdfIrql2							Wdf01000.sys (see Framework Library Versioning.)		PASSIVE_LEVEL	Windows		WdfUsbTargetDeviceIsConnectedSynchronous wdfusb/WdfUsbTargetDeviceIsConnectedSynchronous	APIRef kbSyntax	LibDef	Wdf01000.sys Wdf01000.sys.dll	WdfUsbTargetDeviceIsConnectedSynchronous

WdfUsbTargetDeviceIsConnectedSynchronous function

-description

[Applies to KMDF only]

The WdfUsbTargetDeviceIsConnectedSynchronous method determines if the specified USB device is connected.

-parameters

-param UsbDevice [in]

A handle to a USB device object that was obtained from a previous call to WdfUsbTargetDeviceCreateWithParameters.

-returns

WdfUsbTargetDeviceIsConnectedSynchronous returns the I/O target's completion status value if the operation succeeds. Otherwise, this method can return one of the following values:

Return code	Description
STATUS_INVALID_PARAMETER	An invalid parameter was detected.
STATUS_INVALID_DEVICE_REQUEST	The caller's IRQL was invalid.
STATUS_DEVICE_NOT_CONNECTED or STATUS_DEVICE_DOES_NOT_EXIST	The device was not connected.

 

This method also might return other NTSTATUS values.

A bug check occurs if the driver supplies an invalid object handle.

-remarks

For more information about the WdfUsbTargetDeviceIsConnectedSynchronous method and USB I/O targets, see USB I/O Targets.

Examples

The following code example determines if a specified USB device is connected.

NTSTATUS status;

status = WdfUsbTargetDeviceIsConnectedSynchronous(UsbDevice);

-see-also

WdfUsbTargetDeviceCreateWithParameters