Método IMFMediaSession::Start (mfidl.h)

  • Artículo

Inicia la sesión multimedia.

Sintaxis

HRESULT Start(
  [in] const GUID        *pguidTimeFormat,
  [in] const PROPVARIANT *pvarStartPosition
);

Parámetros

[in] pguidTimeFormat

Puntero a un GUID que especifica el formato de hora para el parámetro pvarStartPosition . Este parámetro puede ser NULL. El valor NULL equivale a pasar GUID_NULL.

Se definen los siguientes GUID de formato de hora:

Valor Significado
GUID_NULL
 Tiempo de presentación. El parámetro pvarStartPosition debe tener uno de los siguientes tipos PROPVARIANT .
  • VT_I8: el parámetro pvarStartPosition contiene la posición inicial en unidades de 100 nanosegundos, en relación con el inicio de la presentación.
  • VT_EMPTY: la reproducción comienza desde la posición actual.
Todos los orígenes multimedia admiten este formato de hora.
MF_TIME_FORMAT_SEGMENT_OFFSET
 Desplazamiento del segmento. Este formato de hora es compatible con el origen del secuenciador. La hora de inicio es un desplazamiento dentro de un segmento.

Llame a la función MFCreateSequencerSegmentOffset para crear el valor PROPVARIANT para el parámetro pvarStartPosition .
MF_TIME_FORMAT_ENTRY_RELATIVE
Nota Requiere Windows 7 o posterior.
 
Vaya a una entrada de lista de reproducción. El parámetro pvarStartPosition especifica el índice de la entrada de lista de reproducción, en relación con la entrada actual. Por ejemplo, el valor 2 omite las dos entradas hacia delante. Para omitir hacia atrás, pase un valor negativo. El tipo PROPVARIANT es VT_I4.

Si un origen multimedia admite este formato de hora, el método IMFMediaSource::GetCharacteristics devuelve una o ambas marcas:

  • MFMEDIASOURCE_CAN_SKIPFORWARD
  • MFMEDIASOURCE_CAN_SKIPBACKWARD

[in] pvarStartPosition

Puntero a un PROPVARIANT que especifica la posición inicial para la reproducción. El significado y el tipo de datos de este parámetro se indican mediante el parámetro pguidTimeFormat .

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_INVALIDREQUEST
 La operación no se puede realizar en el estado actual de la sesión multimedia.
MF_E_SHUTDOWN
 Se ha apagado la sesión multimedia.

Comentarios

Cuando se llama a este método, la sesión multimedia inicia el reloj de presentación y comienza a procesar ejemplos multimedia.

Este método es asincrónico. Cuando se completa el método, la sesión multimedia envía un evento MESessionStarted .

Requisitos

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

Consulte también

IMFMediaSession