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
);

parameters

[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
Library	Mfplat.lib
DLL	Mfplat.dll

另请参阅

媒体基础函数