estructura AM_SAMPLE2_PROPERTIES (strmif.h)
[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.
La estructura AM_SAMPLE2_PROPERTIES describe las propiedades de un ejemplo multimedia. La interfaz IMediaSample2 usa esta estructura.
Sintaxis
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;
Miembros
cbData
Longitud de los datos de propiedad, en bytes. Este miembro de estructura es para extensibilidad.
dwTypeSpecificFlags
Marcas específicas del tipo. Las marcas se definen por separado para cada tipo de medio. El valor predeterminado es AM_VIDEO_FLAG_INTERLEAVED_FRAME (cero). Las marcas siguientes se usan para secuencias de vídeo. Se definen en el archivo de encabezado dvdmedia.h.
| Marca | Significado |
|---|---|
|
Use esta máscara para comprobar si el ejemplo es un campo o un marco. |
|
El ejemplo es un marco. (Use la máscara de bits AM_VIDEO_FLAG_FIELD_MASK para probar este valor). |
|
El ejemplo es el campo 1. (Use la máscara de bits AM_VIDEO_FLAG_FIELD_MASK para probar este valor). |
|
El ejemplo es el campo 2. (Use la máscara de bits AM_VIDEO_FLAG_FIELD_MASK para probar este valor). |
|
Si se establece esta marca, muestre primero el campo 1. De lo contrario, muestre primero el campo 2. (Solo se aplica cuando hay dos campos por ejemplo). |
|
Si se establece esta marca, use el modo de guardado (es decir, no interinterlace el ejemplo). De lo contrario, use el modo bob. Esta marca solo se aplica cuando hay dos campos por ejemplo. |
|
Si se establece esta marca, vuelva a mostrar el primer campo después de mostrar el segundo campo. (Solo se aplica cuando hay dos campos por ejemplo). |
|
Indica el inicio de un VOBU durante la reproducción inversa de vídeo dvd. Para obtener más información, consulta Mejoras de reproducción de DVD en Windows Vista. |
|
Señala el final de un VOBU durante la reproducción inversa de vídeo dvd. El navegador de DVD establece esta marca en una muestra vacía para indicar el final de un VOBU. Para obtener más información, consulta Mejoras de reproducción de DVD en Windows Vista. |
|
Para la reproducción de DVD, indica el punto de la secuencia cuando el descodificador debe aplicar una nueva tecla Content Scramble System (CSS).
El navegador de DVD establece esta marca en una muestra multimedia vacía justo antes de renegociar una clave de título CSS. Anteriormente, el navegador de DVD envió incorrectamente esta clave antes de negociar la clave de disco. A partir de Windows 7, si la propiedad AM_PROPERTY_DVDCOPY_SUPPORTS_NEW_KEYCOUNT del descodificador devuelve TRUE, el navegador de DVD no envía esta marca antes de negociar la clave del disco. Consulte Conjunto de propiedades de protección de copia de DVD. |
Otras marcas se definen pero no se usan actualmente. Consulte dvdmedia.h.
dwSampleFlags
Combinación bit a bit de marcas AM_SAMPLE_PROPERTY_FLAGS tipo de datos enumerado. Los bits no definidos están reservados y deben ser cero.
lActual
Longitud de los datos válidos en el búfer.
tStart
Hora de inicio, si es válida. El miembro dwSampleFlags especifica si este miembro es válido.
tStop
Tiempo de detención, si es válido. El miembro dwSampleFlags especifica si este miembro es válido.
dwStreamId
Stream identificador. Si el valor es AM_STREAM_MEDIA, la secuencia contiene datos multimedia. Si el valor es AM_STREAM_CONTROL, la secuencia contiene información de control. Las aplicaciones pueden definir valores de 0x80000000 o superior para su propio uso. (Consulte AM_SAMPLE_PROPERTY_FLAGS).
pMediaType
Puntero a una estructura de AM_MEDIA_TYPE que especifica el tipo de medio si el formato ha cambiado. Si este formato no ha cambiado, este miembro es NULL.
pbBuffer
Puntero al búfer de ejemplo.
cbBuffer
Tamaño del búfer de ejemplo, en bytes.
Requisitos
| Requisito | Valor |
|---|---|
| Header | strmif.h (incluye Dshow.h) |