WdfUsbTargetDeviceIsConnectedSynchronous method
[Applies to KMDF only]
The WdfUsbTargetDeviceIsConnectedSynchronous method determines if the specified USB device is connected.
Syntax
NTSTATUS WdfUsbTargetDeviceIsConnectedSynchronous(
[in] WDFUSBDEVICE UsbDevice
);
Parameters
- UsbDevice [in]
-
A handle to a USB device object that was obtained from a previous call to WdfUsbTargetDeviceCreateWithParameters.
Return value
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 |
|---|---|
|
An invalid parameter was detected. |
|
The caller's IRQL was invalid. |
|
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);
Requirements
|
Minimum KMDF version | 1.0 |
|---|---|
|
Header |
|
|
Library |
|
|
IRQL | PASSIVE_LEVEL |
|
DDI compliance rules | DriverCreate, KmdfIrql, KmdfIrql2, UsbKmdfIrql, UsbKmdfIrql2 |
See also
