strmif.h) (AM_SAMPLE2_PROPERTIES 结构
[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ，而不是 DirectShow。 如果可能，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。 仅当每个 sample 有两个字段时， (才适用。) |
|
如果设置了此标志，请使用编织模式 (即，不要将示例) 取消交错。 否则，请使用 bob 模式。 仅当每个样本有两个字段时，此标志才适用。 |
|
如果设置了此标志，则显示第二个字段后再次显示第一个字段。 仅当每个 sample 有两个字段时， (才适用。) |
|
在反向播放 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 复制保护属性集。 |
其他标志已定义，但当前未使用。 请参阅 dvdmedia.h。
dwSampleFlags
标记 AM_SAMPLE_PROPERTY_FLAGS 枚举数据类型的按位组合。 未定义的位是保留的，必须为零。
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) |