共用方式為


WdfUsbTargetDeviceIsConnectedSynchronous 函式 (wdfusb.h)

[僅適用於 KMDF]

WdfUsbTargetDeviceIsConnectedSynchronous 方法會判斷指定的 USB 裝置是否已連線。

語法

NTSTATUS WdfUsbTargetDeviceIsConnectedSynchronous(
  [in] WDFUSBDEVICE UsbDevice
);

參數

[in] UsbDevice

從先前呼叫 WdfUsbTargetDeviceCreateWithParameters 取得之 USB 裝置物件的句柄。

傳回值

WdfUsbTargetDeviceIsConnectedSynchronous 如果作業成功,則會傳回 I/O 目標的完成狀態值。 否則,這個方法可以傳回下列其中一個值:

傳回碼 描述
STATUS_INVALID_PARAMETER
偵測到無效的參數。
STATUS_INVALID_DEVICE_REQUEST
呼叫端的 IRQL 無效。
STATUS_DEVICE_NOT_CONNECTED 或STATUS_DEVICE_DOES_NOT_EXIST
裝置未連線。
 

此方法也可能 傳回其他NTSTATUS 值。

如果驅動程式提供無效的物件句柄,就會發生錯誤檢查。

言論

如需 WdfUsbTargetDeviceIsConnectedSynchronous 方法和 USB I/O 目標的詳細資訊,請參閱 USB I/O 目標

例子

下列程式代碼範例會判斷指定的USB裝置是否已連線。

NTSTATUS status;

status = WdfUsbTargetDeviceIsConnectedSynchronous(UsbDevice);

要求

要求 價值
目標平臺 普遍
最低 KMDF 版本 1.0
標頭 wdfusb.h (包括 Wdfusb.h)
連結庫 Wdf01000.sys (請參閱架構連結庫版本控制。)
IRQL PASSIVE_LEVEL
DDI 合規性規則 DriverCreate(kmdf)KmdfIrql(kmdf)KmdfIrql2(kmdf),KmdfIrqlExplicit(kmdf),UsbKmdfIrql(kmdf)UsbKmdfIrql2(kmdf),UsbKmdfIrqlExplicit(kmdf)

另請參閱

WdfUsbTargetDeviceCreateWithParameters