estructura AM_SAMPLE2_PROPERTIES (strmif.h)

Artículo
07/28/2023

[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
AM_VIDEO_FLAG_FIELD_MASK 0x0003	Use esta máscara para comprobar si el ejemplo es un campo o un marco.
AM_VIDEO_FLAG_INTERLEAVED_FRAME 0x0000	El ejemplo es un marco. (Use la máscara de bits AM_VIDEO_FLAG_FIELD_MASK para probar este valor).
AM_VIDEO_FLAG_FIELD1 0x0001	El ejemplo es el campo 1. (Use la máscara de bits AM_VIDEO_FLAG_FIELD_MASK para probar este valor).
AM_VIDEO_FLAG_FIELD2 0x0002	El ejemplo es el campo 2. (Use la máscara de bits AM_VIDEO_FLAG_FIELD_MASK para probar este valor).
AM_VIDEO_FLAG_FIELD1FIRST 0x0004	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).
AM_VIDEO_FLAG_WEAVE 0x0008	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.
AM_VIDEO_FLAG_REPEAT_FIELD 0x0040	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).
AM_ReverseBlockStart 0x2	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.
AM_ReverseBlockEnd 0x4	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.
AM_UseNewCSSKey 0x1	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)

Consulte también

Estructuras directShow

Compartir a través de