共用方式為

MFCreateASFStreamingMediaSinkActivate 函式 (wmcontainer.h)

  • 發行項

建立 ASF 串流接收的啟用物件。

ASF 串流接收可讓應用程式將串流進階系統格式 (ASF) 封包寫入 HTTP 位元組資料流。 啟用物件可用來在另一個進程中建立 ASF 串流接收。

語法

HRESULT MFCreateASFStreamingMediaSinkActivate(
  IMFActivate       *pByteStreamActivate,
  IMFASFContentInfo *pContentInfo,
  IMFActivate       **ppIActivate
);

參數

pByteStreamActivate

啟用物件的 IMFActivate 介面指標。 呼叫端會實作這個介面。 啟用物件的 IMFActivate：：ActivateObject 方法必須建立位元組數據流物件。 位元組數據流會公開 IMFByteStream 介面。 ASF 串流接收會將數據寫入此位元組數據流。

pContentInfo

ASF ContentInfo 物件的指標，其中包含描述 ASF 內容的屬性。 這些設定可以包含數據流設定、編碼屬性和元數據。 如需這些屬性的詳細資訊，請參閱 在 ContentInfo 物件中設定屬性。

ppIActivate

接收啟用物件之 IMFActivate 介面的指標，這個介面是用來建立 ASF 串流媒體接收。 若要建立媒體接收，應用程式必須使用收到的指標呼叫 IMFActivate：：ActivateObject 。 ActivateObject 方法也會在 pByteStreamActivate 所指定的位元組數據流啟動物件上呼叫 IMFActivate：：Activate，以建立它，讓媒體接收可以在位元組數據流中寫入串流內容。 呼叫端必須釋放 ppIActivate 中所接收媒體接收啟用物件的 IMFActivate 介面指標。

傳回值

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

從 Windows 7 開始，Media Foundation 會提供 ASF 串流接收，以在即時串流案例中寫入內容。 此函式應該用於必須在遠端進程中建立和設定此媒體接收的安全轉碼案例。 如同 ASF 檔案接收，新的媒體接收會執行 ASF 相關工作，例如寫入 ASF 標頭、產生數據封包 (多任務處理) 。 內容會寫入呼叫端實作的位元組數據流，例如 HTTP 位元組數據流。 呼叫端也必須提供媒體接收可用來從遠端建立位元組數據流的啟用物件。

此外，它會執行串流受保護內容的轉譯。 它會為處理授權要求和回應的網路裝置輸出信任授權單位 (OTA) 裝載 Windows Media Digital Rights Management (DRM) 。 如需詳細資訊，請參閱 IMFDRMNetHelper 介面。

新的媒體接收不會執行任何時間調整。 如果時鐘搜尋，則時間戳不會變更。

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 wmcontainer.h
程式庫 Mf.lib
Dll Mf.dll

另請參閱

MFCreateASFStreamingMediaSink

媒體基礎函式