AM_SAMPLE2_PROPERTIES struttura (strmif.h)
[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 |
|---|---|
|
Usare questa maschera per verificare se l'esempio è un campo o un frame. |
|
L'esempio è un frame. Usare la maschera AM_VIDEO_FLAG_FIELD_MASK bit per testare questo valore. |
|
L'esempio è il campo 1. Usare la maschera AM_VIDEO_FLAG_FIELD_MASK bit per testare questo valore. |
|
L'esempio è il campo 2. Usare la maschera AM_VIDEO_FLAG_FIELD_MASK bit per testare questo valore. |
|
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. |
|
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. |
|
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. |
|
Segnala l'inizio di un VOBU durante la riproduzione inversa del video DVD. Per altre informazioni, vedere Miglioramenti alla riproduzione DVD in Windows Vista. |
|
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. |
|
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) |