IMFSourceResolver::BeginCreateObjectFromByteStream 方法 (mfidl.h)
开始异步请求,以从字节流创建媒体源。
语法
HRESULT BeginCreateObjectFromByteStream(
[in] IMFByteStream *pByteStream,
[in] LPCWSTR pwszURL,
[in] DWORD dwFlags,
[in] IPropertyStore *pProps,
[out] IUnknown **ppIUnknownCancelCookie,
[in] IMFAsyncCallback *pCallback,
[in] IUnknown *punkState
);
parameters
[in] pByteStream
指向字节流的 IMFByteStream 接口的指针。
[in] pwszURL
一个以 null 结尾的字符串,其中包含字节流的原始 URL。 此参数可以为 NULL。
[in] dwFlags
一个或多个标志的按位 OR 。 请参阅 源冲突解决程序标志。
[in] pProps
指向属性存储的 IPropertyStore 接口的指针。 方法将属性存储传递给字节流处理程序。 字节流处理程序可以使用属性存储来配置媒体源。 此参数可以为 NULL。 有关详细信息,请参阅 配置媒体源。
[out] ppIUnknownCancelCookie
接收 IUnknown 指针或值 NULL。 如果值不为 NULL,可以通过将此指针传递到 IMFSourceResolver::CancelObjectCreation 方法来取消异步操作。 调用方必须释放接口。 此参数可以为 NULL。
[in] pCallback
指向回调对象的 IMFAsyncCallback 接口的指针。 调用方必须实现此接口。
[in] punkState
指向由调用方定义的状态对象的 IUnknown 接口的指针。 此参数可以为 NULL。 可以使用此对象来保存状态信息。 调用回调时,对象将返回到调用方。
返回值
该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
dwFlags 参数包含互斥标志。 |
|
不支持字节流。 |
|
字节流不支持查找。 |
注解
dwFlags 参数必须包含 MF_RESOLUTION_MEDIASOURCE 标志,并且不应包含 MF_RESOLUTION_BYTESTREAM 标志。
源解析程序尝试根据 URL 的文件扩展名或字节流的 MIME 类型 (或两者) 查找字节流的一个或多个字节流处理程序。 URL 在可选的 pwszURL 参数中指定,可以在字节流的 MF_BYTESTREAM_CONTENT_TYPE 属性中指定 MIME 类型。 字节流处理程序按文件扩展名或 MIME 类型注册,或按两者注册,如 方案处理程序和 Byte-Stream 处理程序中所述。 调用方应至少指定其中一个值。
操作完成后,源解析程序将调用 IMFAsyncCallback::Invoke 方法。 Invoke 方法应调用 IMFSourceResolver::EndCreateObjectFromByteStream 以获取指向媒体源的指针。
要求
最低受支持的客户端 | Windows Vista [桌面应用 | UWP 应用] |
最低受支持的服务器 | Windows Server 2008 [桌面应用 | UWP 应用] |
目标平台 | Windows |
标头 | mfidl.h |
Library | Mfuuid.lib |