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。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼	描述
S_OK	此函數已成功。

備註

要求完成時，會呼叫回呼物件的 IMFAsyncCallback：：Invoke 方法。 回呼物件應該接著呼叫 MFEndCreateFile 函式，以取得位元組資料流程的指標。

需求

最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	mfapi.h
程式庫	Mfplat.lib
Dll	Mfplat.dll

另請參閱

媒體基礎函式