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

傳回碼 描述
S_OK
 此方法已成功。
MF_E_SOURCERESOLVER_MUTUALLY_EXCLUSIVE_FLAGS
 dwFlags參數包含互斥旗標。
MF_E_UNSUPPORTED_BYTESTREAM_TYPE
 不支援此位元組資料流程。

備註

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

另請參閱

IMFSourceResolver

來源解析程式