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 で定義されています。
| フラグ | 説明 |
|---|---|
|
サンプルがフィールドかフレームかをチェックするには、このマスクを使用します。 |
|
サンプルはフレームです。 (この値をテストするには、AM_VIDEO_FLAG_FIELD_MASK ビットマスクを使用します)。 |
|
サンプルはフィールド 1 です。 (この値をテストするには、AM_VIDEO_FLAG_FIELD_MASK ビットマスクを使用します)。 |
|
サンプルはフィールド 2 です。 (この値をテストするには、AM_VIDEO_FLAG_FIELD_MASK ビットマスクを使用します)。 |
|
このフラグが設定されている場合は、最初にフィールド 1 を表示します。 それ以外の場合は、フィールド 2 を最初に表示します。 (サンプルごとに 2 つのフィールドがある場合にのみ適用されます)。 |
|
このフラグが設定されている場合は、織りモードを使用します (つまり、サンプルのインターレースを解除しないでください)。 それ以外の場合は、bob モードを使用します。 このフラグは、サンプルごとに 2 つのフィールドがある場合にのみ適用されます。 |
|
このフラグが設定されている場合は、2 番目のフィールドを表示した後、最初のフィールドをもう一度表示します。 (サンプルごとに 2 つのフィールドがある場合にのみ適用されます)。 |
|
DVD ビデオの逆再生中に VOBU の開始を通知します。 詳細については、「 Windows Vista での DVD 再生の機能強化」を参照してください。 |
|
DVD ビデオの逆再生中に VOBU の終了を通知します。 DVD ナビゲーターは、このフラグを空のサンプルに設定して、VOBU の終了を通知します。 詳細については、「 Windows Vista での DVD 再生の機能強化」を参照してください。 |
|
DVD 再生の場合は、デコーダーが新しいコンテンツ スクランブル システム (CSS) キーを適用する必要があるストリーム内のポイントを示します。
DVD ナビゲーターは、CSS タイトル キーを再ネゴシエーションする直前に、空のメディア サンプルにこのフラグを設定します。 以前は、DVD ナビゲーターは、ディスク キーをネゴシエートする前に、このキーを誤って送信しました。 Windows 7 以降では、デコーダーの AM_PROPERTY_DVDCOPY_SUPPORTS_NEW_KEYCOUNT プロパティが TRUE を返した場合、DVD ナビゲーターはディスク キーをネゴシエートする前にこのフラグを送信しません。 「DVD Copy Protection プロパティ セット」を参照してください。 |
その他のフラグは定義されていますが、現在は使用されていません。 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
サンプル バッファーのサイズ (バイト単位)。
要件
| 要件 | 値 |
|---|---|
| Header | strmif.h (Dshow.h を含む) |