AM_SAMPLE2_PROPERTIES-Struktur (strmif.h)

  • Artikel

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die AM_SAMPLE2_PROPERTIES-Struktur beschreibt die Eigenschaften eines Medienbeispiels. Die IMediaSample2-Schnittstelle verwendet diese Struktur.

Syntax

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;

Member

cbData

Länge der Eigenschaftsdaten in Bytes. Dieses Strukturelement dient der Erweiterbarkeit.

dwTypeSpecificFlags

Typspezifische Flags. Flags werden für jeden Medientyp separat definiert. Der Standardwert ist AM_VIDEO_FLAG_INTERLEAVED_FRAME (null). Die folgenden Flags werden für Videostreams verwendet. Sie werden in der Headerdatei dvdmedia.h definiert.

Flag Bedeutung
AM_VIDEO_FLAG_FIELD_MASK
0x0003
 Verwenden Sie diese Maske, um zu überprüfen, ob es sich bei dem Beispiel um ein Feld oder einen Frame handelt.
AM_VIDEO_FLAG_INTERLEAVED_FRAME
0x0000
 Das Beispiel ist ein Frame. (Verwenden Sie die AM_VIDEO_FLAG_FIELD_MASK Bitmaske, um diesen Wert zu testen.)
AM_VIDEO_FLAG_FIELD1
0x0001
 Das Beispiel ist Feld 1. (Verwenden Sie die AM_VIDEO_FLAG_FIELD_MASK Bitmaske, um diesen Wert zu testen.)
AM_VIDEO_FLAG_FIELD2
0x0002
 Das Beispiel ist das Feld 2. (Verwenden Sie die AM_VIDEO_FLAG_FIELD_MASK Bitmaske, um diesen Wert zu testen.)
AM_VIDEO_FLAG_FIELD1FIRST
0x0004
 Wenn dieses Flag festgelegt ist, zeigen Sie zuerst Feld 1 an. Andernfalls zeigen Sie zuerst Feld 2 an. (Gilt nur, wenn pro Beispiel zwei Felder vorhanden sind.)
AM_VIDEO_FLAG_WEAVE
0x0008
 Wenn dieses Flag festgelegt ist, verwenden Sie den Webmodus (d. a. deinterlace the sample). Verwenden Sie andernfalls den Bob-Modus. Dieses Flag gilt nur, wenn pro Beispiel zwei Felder vorhanden sind.
AM_VIDEO_FLAG_REPEAT_FIELD
0x0040
 Wenn dieses Flag festgelegt ist, zeigen Sie das erste Feld nach dem Anzeigen des zweiten Felds erneut an. (Gilt nur, wenn pro Beispiel zwei Felder vorhanden sind.)
AM_ReverseBlockStart
0x2
 Signalisiert den Start einer VOBU während der umgekehrten Wiedergabe von DVD-Videos. Weitere Informationen finden Sie unter Verbesserungen der DVD-Wiedergabe in Windows Vista.
AM_ReverseBlockEnd
0x4
 Signalisiert das Ende einer VOBU während der umgekehrten Wiedergabe von DVD-Videos. Der DVD-Navigator legt dieses Flag für ein leeres Beispiel fest, um das Ende eines VOBU zu signalisieren. Weitere Informationen finden Sie unter Verbesserungen der DVD-Wiedergabe in Windows Vista.
AM_UseNewCSSKey
0x1
 Gibt für die DVD-Wiedergabe den Punkt im Stream an, an dem der Decoder eine neue CSS-Taste (Content Scramble System) anwenden soll.

Der DVD-Navigator legt dieses Flag für ein leeres Medienbeispiel fest, kurz bevor ein CSS-Titelschlüssel neu ausgehandelt wird.

Zuvor hat der DVD Navigator diesen Schlüssel fälschlicherweise gesendet, bevor er den Datenträgerschlüssel aushandelte. Wenn ab Windows 7 die AM_PROPERTY_DVDCOPY_SUPPORTS_NEW_KEYCOUNT Eigenschaft des Decoders TRUE zurückgibt, sendet der DVD-Navigator dieses Flag nicht, bevor er die Datenträgertaste aushandelt. Weitere Informationen finden Sie unter DVD Copy Protection Property Set.
 

Andere Flags werden definiert, aber derzeit nicht verwendet. Siehe dvdmedia.h.

dwSampleFlags

Bitweise Kombination von Flags für den AM_SAMPLE_PROPERTY_FLAGS aufgelisteten Datentyp. Nicht definierte Bits sind reserviert und müssen null sein.

lActual

Länge der gültigen Daten im Puffer.

tStart

Startzeit, sofern gültig. Das dwSampleFlags-Element gibt an, ob dieses Element gültig ist.

tStop

Stoppzeit, falls gültig. Das dwSampleFlags-Element gibt an, ob dieses Element gültig ist.

dwStreamId

Stream Bezeichner. Wenn der Wert AM_STREAM_MEDIA ist, enthält der Stream Mediendaten. Wenn der Wert AM_STREAM_CONTROL ist, enthält der Stream Steuerelementinformationen. Anwendungen können Werte von 0x80000000 oder höher für die eigene Verwendung definieren. (Siehe AM_SAMPLE_PROPERTY_FLAGS.)

pMediaType

Zeiger auf eine AM_MEDIA_TYPE-Struktur , die den Medientyp angibt, wenn sich das Format geändert hat. Wenn dieses Format nicht geändert wurde, ist dieses Element NULL.

pbBuffer

Zeiger auf den Beispielpuffer.

cbBuffer

Größe des Beispielpuffers in Bytes.

Anforderungen

Anforderung Wert
Header strmif.h (include Dshow.h)

Weitere Informationen

DirectShow-Strukturen