IWDFIoTarget::GetTargetFile メソッド (wudfddi.h)
警告
UMDF 2 は UMDF の最新バージョンであり、UMDF 1 よりも優先されます。 すべての新しい UMDF ドライバーは、UMDF 2 を使用して記述する必要があります。 UMDF 1 には新機能が追加されておらず、新しいバージョンのWindows 10では UMDF 1 のサポートが制限されています。 ユニバーサル Windows ドライバーでは UMDF 2 を使用する必要があります。 詳細については、「UMDF を使用したはじめに」を参照してください。
GetTargetFile メソッドは、I/O ターゲット オブジェクトに関連付けられているフレームワーク ファイル オブジェクトを取得します。
構文
void GetTargetFile(
[out] IWDFFile **ppWdfFile
);
パラメーター
[out] ppWdfFile
I/O ターゲットのファイル オブジェクトの IWDFFile インターフェイスへのポインターを受け取るバッファーへのポインター。
戻り値
なし
解説
フレームワーク ファイル オブジェクトが I/O ターゲット オブジェクトに関連付けられている場合、フレームワークには、ドライバーが I/O ターゲット オブジェクトに送信する I/O 要求を含むファイル オブジェクトが含まれます。
ドライバーが I/O 要求の書式を設定すると、I/O ターゲット オブジェクトを使用すると、ドライバーは、要求が開始したのと同じファイルまたは新しいファイルを使用できます。
既定の I/O ターゲットにはファイル オブジェクトがないため、既定の I/O ターゲットの GetTargetFile を呼び出すと NULL が取得されます。
I/O ターゲットの詳細については、「 UMDF での I/O ターゲットの使用」を参照してください。
例
GetTargetFile メソッドの使用方法のコード例については、「IWDFIoTarget::FormatRequestForWrite」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポート終了 | UMDF 2.0 以降では使用できません。 |
| 対象プラットフォーム | デスクトップ |
| 最小 UMDF バージョン | 1.5 |
| Header | wudfddi.h (Wudfddi.h を含む) |
| [DLL] | WUDFx.dll |