MFBeginCreateFile 函式 (mfapi.h)
開始非同步要求，以從檔案建立位元組資料流程。
語法
HRESULT MFBeginCreateFile(
[in] MF_FILE_ACCESSMODE AccessMode,
[in] MF_FILE_OPENMODE OpenMode,
[in] MF_FILE_FLAGS fFlags,
[in] LPCWSTR pwszFilePath,
[in] IMFAsyncCallback *pCallback,
[in] IUnknown *pState,
[out] IUnknown **ppCancelCookie
);
參數
[in] AccessMode
要求的存取模式，指定為 MF_FILE_ACCESSMODE 列舉的成員。
[in] OpenMode
如果檔案已經存在或不存在，則為函式的行為，指定為 MF_FILE_OPENMODE 列舉的成員。
[in] fFlags
來自MF_FILE_FLAGS列舉值的位OR。
[in] pwszFilePath
包含檔案名之 Null 終止字串的指標。
[in] pCallback
回呼物件的 IMFAsyncCallback 介面指標。 呼叫端必須實作此介面
[in] pState
狀態物件的 IUnknown 介面指標，由呼叫端定義。 此參數可以是 Null。 您可以使用這個物件來保存狀態資訊。 叫用回呼時，物件會傳回給呼叫端。
[out] ppCancelCookie
接收 IUnknown 指標或 Null值。 如果此值不是 Null，您可以將這個指標傳遞至 MFCancelCreateFile 函式，以取消非同步作業。 呼叫端必須釋放 介面。 這個參數是選擇性的，而且可以是 Null。
傳回值
函式會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
| 傳回碼 | 描述 |
|---|---|
|
此函數已成功。 |
備註
要求完成時，會呼叫回呼物件的 IMFAsyncCallback：：Invoke 方法。 回呼物件應該接著呼叫 MFEndCreateFile 函式，以取得位元組資料流程的指標。
需求
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | mfapi.h |
| 程式庫 | Mfplat.lib |
| Dll | Mfplat.dll |