AM_SAMPLE2_PROPERTIES 構造体 (strmif.h)

[このページに関連付けられている機能 DirectShow は、従来の機能です。 MediaPlayer、IMFMediaEngine、および Media Foundation のオーディオ/ビデオ キャプチャに置き換わりました。 これらの機能は、Windows 10とWindows 11用に最適化されています。 新しいコードでは、可能であれば、DirectShow ではなく Media Foundation で MediaPlayer、IMFMediaEngine、Audio/Video Capture を使用することを強くお勧めします。 Microsoft は、従来の API を使用する既存のコードを、可能であれば新しい API を使用するように書き直すよう提案しています。]

AM_SAMPLE2_PROPERTIES構造体では、メディア サンプルのプロパティについて説明します。 IMediaSample2 インターフェイスはこの構造体を使用します。

構文

typedef struct tagAM_SAMPLE2_PROPERTIES {
  DWORD          cbData;
  DWORD          dwTypeSpecificFlags;
  DWORD          dwSampleFlags;
  LONG           lActual;
  REFERENCE_TIME tStart;
  REFERENCE_TIME tStop;
  DWORD          dwStreamId;
  AM_MEDIA_TYPE  *pMediaType;
  BYTE           *pbBuffer;
  LONG           cbBuffer;
} AM_SAMPLE2_PROPERTIES;

メンバー

cbData

プロパティ データの長さ (バイト単位)。 この構造体メンバーは、機能拡張を目的とします。

dwTypeSpecificFlags

型固有のフラグ。 フラグは、メディアの種類ごとに個別に定義されます。 既定値は AM_VIDEO_FLAG_INTERLEAVED_FRAME (ゼロ) です。 ビデオ ストリームには、次のフラグが使用されます。 これらは、ヘッダー ファイル dvdmedia.h で定義されています。

その他のフラグは定義されていますが、現在は使用されていません。 dvdmedia.h を参照してください。

dwSampleFlags

のビットごとの組み合わせは、列挙されたデータ型 AM_SAMPLE_PROPERTY_FLAGS フラグを設定します。 未定義のビットは予約されており、0 である必要があります。

lActual

バッファー内の有効なデータの長さ。

tStart

開始時刻 (有効な場合)。 dwSampleFlags メンバーは、このメンバーが有効かどうかを指定します。

tStop

時間を停止します (有効な場合)。 dwSampleFlags メンバーは、このメンバーが有効かどうかを指定します。

dwStreamId

Stream識別子。 値がAM_STREAM_MEDIAの場合、ストリームにはメディア データが含まれます。 値がAM_STREAM_CONTROLの場合、ストリームには制御情報が含まれます。 アプリケーションでは、独自に使用するために 0x80000000 以上の値を定義できます。 ( 「AM_SAMPLE_PROPERTY_FLAGS」を参照してください)。

pMediaType

形式が変更された場合にメディアの種類を指定する AM_MEDIA_TYPE 構造体へのポインター。 この形式が変更されていない場合、このメンバーは NULL です。

pbBuffer

サンプル バッファーへのポインター。

cbBuffer

サンプル バッファーのサイズ (バイト単位)。

要件

こちらもご覧ください

DirectShow 構造体