_MFT_OUTPUT_DATA_BUFFER_FLAGS列挙 (mftransform.h)

  • [アーティクル]

IMFTransform::P rocessOutput メソッドのフラグを定義します。

構文

typedef enum _MFT_OUTPUT_DATA_BUFFER_FLAGS {
  MFT_OUTPUT_DATA_BUFFER_INCOMPLETE = 0x1000000,
  MFT_OUTPUT_DATA_BUFFER_FORMAT_CHANGE = 0x100,
  MFT_OUTPUT_DATA_BUFFER_STREAM_END = 0x200,
  MFT_OUTPUT_DATA_BUFFER_NO_SAMPLE = 0x300
} ;

定数

 
MFT_OUTPUT_DATA_BUFFER_INCOMPLETE
値: 0x1000000
MFT は、これ以上入力を受け取ることなく、このストリームから出力を生成できます。 もう一度 ProcessOutput を呼び出して、入力データの次のバッチを処理します。
MFT_OUTPUT_DATA_BUFFER_FORMAT_CHANGE
値: 0x100
この出力ストリームで形式が変更されたか、このストリームの新しい優先形式があります。 このフラグを設定すると、MFT はストリームのメディアの種類をクリアします。 ProcessOutput メソッドは、MF_E_TRANSFORM_STREAM_CHANGEを返し、ストリームの出力を生成しません。 IMFTransform::P rocessInput または ProcessOutput のその他の呼び出しは、クライアントが新しいメディアの種類を設定するまで失敗します。
MFT_OUTPUT_DATA_BUFFER_STREAM_END
値: 0x200
MFT によって、この出力ストリームが削除されました。 出力ストリームには、MFT_OUTPUT_STREAM_REMOVABLE フラグが必要です。 (「 IMFTransform::GetOutputStreamInfo」を参照してください)。

MFT が出力ストリームを削除すると、MFT は、最後の出力サンプルが生成された後の ProcessOutput の次の呼び出しで、この状態コードを返します。 MFT は、この状態コードを返すときに、MFT_OUTPUT_DATA_BUFFER構造体の pSample メンバーに含まれるサンプルを変更したり、pSample が NULL の場合に新しいサンプルを割り当てたりすることはありません。

この状態コードが返されると、この出力ストリームのストリーム識別子は無効になります。 クライアントは、ProcessOutput を呼び出すときに、そのストリームのMFT_OUTPUT_DATA_BUFFER構造を提供しなくなります。

ProcessOutput メソッドは、このリターン コードを必要とする別のストリームに変更がない限り、ストリームの終了時にMF_E_TRANSFORM_STREAM_CHANGEを返しません。
MFT_OUTPUT_DATA_BUFFER_NO_SAMPLE
値: 0x300
このストリームの準備ができているサンプルはありません。 このフラグは、MFT に異なる時刻にデータを生成する複数の出力ストリームがある場合に設定される場合があります。 このフラグは、データを生成する準備ができていないストリームごとに設定されます。 MFT_OUTPUT_DATA_BUFFER構造体の pSample メンバーに含まれる出力サンプルを変更したり、pSample が NULL である新しいサンプルを割り当てたりすることはありません。

出力を生成する準備ができているストリームがない場合、MFT はこのフラグを設定しません。 代わりに、 ProcessOutput メソッドはMF_E_TRANSFORM_NEED_MORE_INPUTを返します。

解説

この列挙体の値はビット フラグではありません。そのため、ビットごとの OR と組み合わせてはいけません。 また、呼び出し元は、ビットごとの AND ではなく、等値演算子を使用してこれらのフラグをテストする必要があります。

// Correct.
if (Buffer.dwStatus == MFT_OUTPUT_DATA_BUFFER_STREAM_END)
{
    ...
}

// Incorrect.
if ((Buffer.dwStatus & MFT_OUTPUT_DATA_BUFFER_STREAM_END) != 0)
{
    ...
}

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリ | UWP アプリ]
Header mftransform.h

関連項目

Media Foundation 列挙

Media Foundation Transforms