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 |
ヘッダー | wudfddi.h (Wudfddi.h を含む) |
DLL | WUDFx.dll |
関連項目
- IWDFFile の
- UMDF での I/O ターゲットの使用の
- IWDFIoTarget の
- IWDFIoTarget::FormatRequestForWrite