IWDFIoTarget：：GetTargetFile 方法 (wudfddi.h)

警告

UMDF 2 是最新版的 UMDF，並取代 UMDF 1。 所有新的UMDF驅動程式都應該使用UMDF 2撰寫。 未將新功能新增至 UMDF 1，且較新版本的 #D2C93D6ED0FC54B7E9BBA37F917BBADAC 上，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