IMFSourceResolver::CreateObjectFromByteStream 方法 (mfidl.h)
從位元組資料流程建立媒體來源。 這個方法是同步方法。
語法
HRESULT CreateObjectFromByteStream(
[in] IMFByteStream *pByteStream,
[in] LPCWSTR pwszURL,
[in] DWORD dwFlags,
[in] IPropertyStore *pProps,
[out] MF_OBJECT_TYPE *pObjectType,
[out] IUnknown **ppObject
);
參數
[in] pByteStream
位元組資料流程之 IMFByteStream 介面的指標。
[in] pwszURL
包含位元組資料流程 URL 的 Null 終止字串。 URL 是選擇性的,可以是 Null。 如需詳細資訊,請參閱「備註」。
[in] dwFlags
旗標的位 OR 。 請參閱 來源解析程式旗標。
[in] pProps
屬性存放區的 IPropertyStore 介面指標。 方法會將屬性存放區傳遞至位元組資料流程處理常式。 位元組資料流程處理常式可以使用屬性存放區來設定媒體來源。 此參數可以是 Null。 如需詳細資訊,請參閱 設定媒體來源。
[out] pObjectType
接收 MF_OBJECT_TYPE 列舉的成員,並指定所建立的物件類型。
[out] ppObject
接收媒體來源 IUnknown 介面的指標。 呼叫端必須釋放 介面。
傳回值
方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
傳回碼 | 描述 |
---|---|
|
此方法已成功。 |
|
dwFlags參數包含互斥旗標。 |
|
不支援此位元組資料流程。 |
備註
dwFlags參數必須包含MF_RESOLUTION_MEDIASOURCE旗標,且不應包含MF_RESOLUTION_BYTESTREAM旗標。
來源解析程式會根據 URL 的副檔名或位元組資料流程的 MIME 類型,嘗試尋找位元組資料流程的一或多個位元組資料流程處理常式, (或兩者) 。 URL 是在選擇性 pwszURL 參數中指定,而 MIME 類型可以在位元組資料流程的 MF_BYTESTREAM_CONTENT_TYPE 屬性中指定。 位元組資料流程處理常式是以副檔名或 MIME 類型或兩者註冊,如 配置處理常式和 Byte-Stream 處理常式中所述。 如果可能的話,呼叫端應該至少指定下列其中一個值, (這兩個值) :
- 在 pwszURL 參數中指定 URL。
- 在位元組資料流程上設定 MF_BYTESTREAM_CONTENT_TYPE 屬性,以指定 MIME 類型。 (根據位元組資料流程的建立方式,可能會設定此屬性。)
需求
最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | mfidl.h |
程式庫 | Mfuuid.lib |