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
Header	wdfusb.h (Wdfusb.h を含む)
Library	Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則	DriverCreate(kmdf)、 KmdfIrql(kmdf)、 KmdfIrql2(kmdf)、KmdfIrqlExplicit(kmdf)、 UsbKmdfIrql(kmdf)、 UsbKmdfIrql2(kmdf)、UsbKmdfIrqlExplicit(kmdf)