AM_SAMPLE2_PROPERTIES struttura (strmif.h)

  • Articolo

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

La struttura AM_SAMPLE2_PROPERTIES descrive le proprietà di un esempio multimediale. L'interfaccia IMediaSample2 usa questa struttura.

Sintassi

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;

Members

cbData

Lunghezza dei dati delle proprietà, in byte. Questo membro della struttura è per l'estendibilità.

dwTypeSpecificFlags

Flag specifici del tipo. I flag vengono definiti separatamente per ogni tipo di supporto. Il valore predefinito è AM_VIDEO_FLAG_INTERLEAVED_FRAME (zero). I flag seguenti vengono usati per i flussi video. Sono definiti nel file di intestazione dvdmedia.h.

Contrassegno Significato
AM_VIDEO_FLAG_FIELD_MASK
0x0003
 Usare questa maschera per verificare se l'esempio è un campo o un frame.
AM_VIDEO_FLAG_INTERLEAVED_FRAME
0x0000
 L'esempio è un frame. Usare la maschera AM_VIDEO_FLAG_FIELD_MASK bit per testare questo valore.
AM_VIDEO_FLAG_FIELD1
0x0001
 L'esempio è il campo 1. Usare la maschera AM_VIDEO_FLAG_FIELD_MASK bit per testare questo valore.
AM_VIDEO_FLAG_FIELD2
0x0002
 L'esempio è il campo 2. Usare la maschera AM_VIDEO_FLAG_FIELD_MASK bit per testare questo valore.
AM_VIDEO_FLAG_FIELD1FIRST
0x0004
 Se questo flag è impostato, visualizzare prima il campo 1. In caso contrario, visualizzare il campo 2 per primo. Si applica solo quando sono presenti due campi per esempio.
AM_VIDEO_FLAG_WEAVE
0x0008
 Se questo flag è impostato, usare la modalità weave ,ovvero non dinterlace l'esempio. In caso contrario, usare la modalità bob. Questo flag si applica solo quando sono presenti due campi per esempio.
AM_VIDEO_FLAG_REPEAT_FIELD
0x0040
 Se questo flag è impostato, visualizzare di nuovo il primo campo dopo aver visualizzato il secondo campo. Si applica solo quando sono presenti due campi per esempio.
AM_ReverseBlockStart
0x2
 Segnala l'inizio di un VOBU durante la riproduzione inversa del video DVD. Per altre informazioni, vedere Miglioramenti alla riproduzione DVD in Windows Vista.
AM_ReverseBlockEnd
0x4
 Segnala la fine di un VOBU durante la riproduzione inversa del video DVD. Il navigatore DVD imposta questo flag su un esempio vuoto per segnalare la fine di un VOBU. Per altre informazioni, vedere Miglioramenti alla riproduzione DVD in Windows Vista.
AM_UseNewCSSKey
0x1
 Per la riproduzione DVD, indica il punto nel flusso quando il decodificatore deve applicare una nuova chiave CSS (Content Scramble System).

Il navigatore DVD imposta questo flag su un esempio multimediale vuoto appena prima di rinegoziare una chiave del titolo CSS.

In precedenza, lo strumento di navigazione DVD ha inviato correttamente questa chiave prima di negoziare la chiave del disco. A partire da Windows 7, se la proprietà di AM_PROPERTY_DVDCOPY_SUPPORTS_NEW_KEYCOUNT del decodificatore restituisce TRUE, il navigatore DVD non invia questo flag prima di negoziare la chiave del disco. Vedere DVD Copy Protection Property Set.
 

Altri flag sono definiti ma non attualmente usati. Vedere dvdmedia.h.

dwSampleFlags

Combinazione bit per bit di flag il tipo di dati enumerato AM_SAMPLE_PROPERTY_FLAGS . I bit non definiti sono riservati e devono essere zero.

lActual

Lunghezza dei dati validi nel buffer.

tStart

Ora di inizio, se valida. Il membro dwSampleFlags specifica se questo membro è valido.

tStop

Arrestare il tempo, se valido. Il membro dwSampleFlags specifica se questo membro è valido.

dwStreamId

Stream identificatore. Se il valore è AM_STREAM_MEDIA, il flusso contiene dati multimediali. Se il valore è AM_STREAM_CONTROL, il flusso contiene informazioni di controllo. Le applicazioni possono definire valori di 0x80000000 o maggiore per il proprio uso. Vedere AM_SAMPLE_PROPERTY_FLAGS.

pMediaType

Puntatore a una struttura AM_MEDIA_TYPE che specifica il tipo di supporto se il formato è stato modificato. Se questo formato non è stato modificato, questo membro è NULL.

pbBuffer

Puntatore al buffer di esempio.

cbBuffer

Dimensioni del buffer di esempio, in byte.

Requisiti

Requisito Valore
Intestazione strmif.h (include Dshow.h)

Vedi anche

Strutture DirectShow