USB I/O ターゲットによるファイルの作成

警告

UMDF 2 は UMDF の最新バージョンであり、UMDF 1 に取って代わるものです。 すべての新しい UMDF ドライバーは、UMDF 2 を使用して記述する必要があります。 UMDF 1 には新機能が追加されておらず、Windows 10 の新しいバージョンでは UMDF 1 のサポートが制限されています。 ユニバーサル Windows ドライバーでは、UMDF 2 を使用する必要があります。

アーカイブされた UMDF 1 サンプルは、Windows 11, バージョン 22H2 - 2022 年 5 月 ドライバー サンプル アップデートでご確認いただけます。

詳しくは、UMDFの概要をご覧ください。

USB I/O ターゲットは初期化中、スタック内ファイル オブジェクトを作成します。これは、USB I/O ターゲットが開いたままにする既定のセッションを表します。 スタック内ファイル オブジェクトの詳細については、「I/O を処理するファイル オブジェクトの作成」を参照してください。 USB I/O ターゲットまたはその USB パイプ ターゲットの子は、このファイル オブジェクトを使用して、送信元の I/O (たとえば、USB 構成記述子を取得する I/O) を送信します。

ドライバーは、このファイル オブジェクトの既定のセッションで I/O を送信する必要がある場合、形式の関数でこのスタック内ファイル オブジェクトを使用できます (たとえば、ドライバーは、IWDFIoTarget::FormatRequestForRead メソッドの呼び出しで pFile パラメーターにこのファイル オブジェクトへのポインターを渡すことができます)。 スタック内ファイル オブジェクトを取得するために、ドライバーは IWDFIoTarget::GetTargetFile メソッドを呼び出すことができます。

このスタック内ファイル オブジェクトは、ドライバーが I/O ターゲットで IWDFObject::D eleteWdfObject メソッドを呼び出して明示的にI/O ターゲットが破棄される場合、または I/O ターゲットの親が破棄されるときに暗黙的に破棄される場合に、閉じられます。

デバイスの削除時にこのスタック内ファイル オブジェクトで未処理の I/O が残っている場合、このファイル オブジェクトは閉じられず、UMDF によってドライバーの停止が生成されます。 詳細については、「ドライバーによって作成されたファイル オブジェクトの作成と使用」を参照してください。