Método IMFMediaSink::GetCharacteristics (mfidl.h)

  • Artículo

Obtiene las características del receptor de medios.

Sintaxis

HRESULT GetCharacteristics(
  [out] DWORD *pdwCharacteristics
);

Parámetros

[out] pdwCharacteristics

Recibe un OR bit a bit de cero o más marcas. Se definen las marcas siguientes:

Valor Significado
MEDIASINK_FIXED_STREAMS
0x00000001
 El receptor multimedia tiene un número fijo de secuencias. No admite los métodos IMFMediaSink::AddStreamSink y IMFMediaSink::RemoveStreamSink . Esta marca es una sugerencia para la aplicación.
MEDIASINK_CANNOT_MATCH_CLOCK
0x00000002
 El receptor de medios no puede coincidir con las tasas con un reloj externo.

Para obtener los mejores resultados, este receptor de medios debe usarse como origen de hora para el reloj de presentación. Si se usa cualquier otro origen de hora, el receptor de medios no puede coincidir con las tasas con el reloj, con resultados deficientes (por ejemplo, glitching).

Esta marca se debe usar con moderación, ya que limita cómo se puede configurar la canalización.

Para obtener más información sobre el reloj de presentación, vea Reloj de presentación.
MEDIASINK_RATELESS
0x00000004
 El receptor de medios no tiene velocidad. Consume muestras lo más rápido posible y no se sincroniza con un reloj de presentación.

La mayoría de los receptores de archivado no tienen velocidad.
MEDIASINK_CLOCK_REQUIRED
0x00000008
 El receptor de medios requiere un reloj de presentación. El reloj de presentación se establece llamando al método IMFMediaSink::SetPresentationClock del receptor multimedia.

Esta marca está obsoleta, ya que todos los receptores multimedia deben admitir el método SetPresentationClock , incluso si el receptor de medios omite el reloj (como en un receptor de medios sin frecuencia).
MEDIASINK_CAN_PREROLL
0x00000010
 El receptor de medios puede aceptar muestras de inscripción previa antes de que se inicie el reloj de presentación. El receptor de medios expone la interfaz IMFMediaSinkPreroll .
MEDIASINK_REQUIRE_REFERENCE_MEDIATYPE
0x00000020
 El primer receptor de flujo (índice 0) es un flujo de referencia. La secuencia de referencia debe tener un tipo de medio para que los tipos de medios se puedan establecer en los demás receptores de secuencias.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
MF_E_SHUTDOWN
 Se ha llamado al método Shutdown del receptor de medios.

Comentarios

Las características de un receptor de medios se fijan a lo largo del tiempo de vida del receptor.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado mfidl.h
Library Mfuuid.lib

Consulte también

IMFMediaSink

Receptores de medios