WdfUsbTargetDeviceIsConnectedSynchronous 関数 (wdfusb.h)
[KMDF にのみ適用]
WdfUsbTargetDeviceIsConnectedSynchronous メソッドは、指定された USB デバイスが接続されているかどうかを判断します。
構文
NTSTATUS WdfUsbTargetDeviceIsConnectedSynchronous(
[in] WDFUSBDEVICE UsbDevice
);
パラメーター
[in] UsbDevice
WdfUsbTargetDeviceCreateWithParameters の以前の呼び出しから取得された USB デバイス オブジェクトへのハンドル。
戻り値
操作が成功した場合、WdfUsbTargetDeviceIsConnectedSynchronous は I/O ターゲットの完了状態値を返します。 それ以外の場合、このメソッドは次のいずれかの値を返すことができます。
| リターン コード | 説明 |
|---|---|
|
無効なパラメーターが検出されました。 |
|
呼び出し元の IRQL が無効でした。 |
|
デバイスが接続されていません。 |
このメソッドは、他の 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) |