IMFASFContentInfo::GenerateHeader メソッド (wmcontainer.h)

MFASFContentInfo オブジェクト内のデータをバイナリ Advanced Systems Format (ASF) ヘッダーにエンコードします。

構文

HRESULT GenerateHeader(
  [in, out] IMFMediaBuffer *pIHeader,
  [out]     DWORD          *pcbHeader
);

[in, out] pIHeader

エンコードされたヘッダーを受け取るバッファーオブジェクトの IMFMediaBuffer インターフェイスへのポインター。ヘッダーのサイズを取得するには 、NULL に設定します。

[out] pcbHeader

エンコードされた ASF ヘッダーのサイズ (バイト単位)。 pIHeader が NULL の場合、この値はエンコードされたヘッダーを保持するために必要なバッファーサイズに設定されます。

このメソッドは HRESULT を返します。有効な値を次の表に示しますが、これ以外にもあります。

リターンコード	説明
S_OK	メソッドが成功しました。
MF_E_INVALIDREQUEST	ContentInfo オブジェクトが参照先のメディアに対して ASF ヘッダーオブジェクトが存在しません。
MF_E_ASF_INVALIDDATA	ASF ヘッダーオブジェクトのサイズが 10 MB を超えています。
MF_E_BUFFERTOOSMALL	pIHeader で渡されるバッファーは、ASF ヘッダーオブジェクト情報を保持するのに十分な大きさではありません。

pcbHeader パラメーターで受け取ったサイズには、パディングサイズが含まれます。コンテンツ情報は、ASF ヘッダーオブジェクトのサイズに応じて、パディングデータを縮小または拡張します。

この呼び出し中、ストリームプロパティはプロファイルのエンコードプロパティに基づいて設定されます。これらのプロパティは、 IMFMetadata インターフェイスを介して使用できます。