AM_SAMPLE2_PROPERTIES-Struktur (strmif.h)
[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 |
|---|---|
|
Verwenden Sie diese Maske, um zu überprüfen, ob es sich bei dem Beispiel um ein Feld oder einen Frame handelt. |
|
Das Beispiel ist ein Frame. (Verwenden Sie die AM_VIDEO_FLAG_FIELD_MASK Bitmaske, um diesen Wert zu testen.) |
|
Das Beispiel ist Feld 1. (Verwenden Sie die AM_VIDEO_FLAG_FIELD_MASK Bitmaske, um diesen Wert zu testen.) |
|
Das Beispiel ist das Feld 2. (Verwenden Sie die AM_VIDEO_FLAG_FIELD_MASK Bitmaske, um diesen Wert zu testen.) |
|
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.) |
|
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. |
|
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.) |
|
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. |
|
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. |
|
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) |