MFCreateASFStreamingMediaSinkActivate 関数 (wmcontainer.h)

  • [アーティクル]

ASF ストリーミング シンクのアクティブ化オブジェクトを作成します。

ASF ストリーミング シンクを使用すると、アプリケーションはストリーミング Advanced Systems Format (ASF) パケットを HTTP バイト ストリームに書き込みます。 アクティブ化オブジェクトを使用して、別のプロセスで ASF ストリーミング シンクを作成できます。

構文

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

パラメーター

pByteStreamActivate

アクティブ化オブジェクトの IMFActivate インターフェイスへのポインター。 呼び出し元はこのインターフェイスを実装します。 アクティブ化オブジェクトの IMFActivate::ActivateObject メソッドは、バイト ストリーム オブジェクトを作成する必要があります。 バイト ストリームは IMFByteStream インターフェイスを公開します。 ASF ストリーミング シンクは、このバイト ストリームにデータを書き込みます。

pContentInfo

ASF コンテンツを記述するプロパティを含む ASF ContentInfo オブジェクト へのポインター。 これらの設定には、ストリーム設定、エンコード プロパティ、メタデータを含めることができます。 これらのプロパティの詳細については、「 ContentInfo オブジェクトのプロパティの設定」を参照してください。

ppIActivate

ASF ストリーミング メディア シンクの作成に使用されるアクティブ化オブジェクトの IMFActivate インターフェイスへのポインターを受け取ります。 メディア シンクを作成するには、受信したポインターを使用して、アプリケーションで IMFActivate::ActivateObject を呼び出す必要があります。 ActivateObject メソッドは、pByteStreamActivate で指定されたバイト ストリーム activate オブジェクトに対して 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
Library Mf.lib
[DLL] Mf.dll

こちらもご覧ください

MFCreateASFStreamingMediaSink

メディア ファンデーション機能