Compartir a través de

Método IMFSinkWriter::P laceMarker (mfreadwrite.h)

  • Artículo

Places un marcador en la secuencia especificada.

Sintaxis

HRESULT PlaceMarker(
  [in] DWORD  dwStreamIndex,
  [in] LPVOID pvContext
);

Parámetros

[in] dwStreamIndex

Índice de base cero de la secuencia.

[in] pvContext

Puntero a un valor definido por la aplicación. El valor de este parámetro se devuelve al autor de la llamada en el parámetro pvContext del método de devolución de llamada IMFSinkWriterCallback::OnMarker del autor de la llamada. La aplicación es responsable de cualquier asignación de memoria asociada a estos datos. Este parámetro puede ser NULL.

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 solicitud no es válida.

Comentarios

Para usar este método, debe proporcionar una devolución de llamada asincrónica al crear el escritor receptor. De lo contrario, el método devuelve MF_E_INVALIDREQUEST. Para obtener más información, consulte MF_SINK_WRITER_ASYNC_CALLBACK.

Los marcadores proporcionan una manera de recibir notificaciones cuando el receptor multimedia consume todas las muestras de una secuencia hasta un punto determinado. El receptor de medios no procesa el marcador hasta que haya procesado todas las muestras que vinieron antes del marcador. Cuando el receptor multimedia procesa el marcador, el escritor receptor llama al método OnMarker de la aplicación. Cuando se invoca la devolución de llamada, sabe que el receptor ha consumido todos los ejemplos anteriores de esa secuencia.

Por ejemplo, para cambiar el formato midstream, llame a PlaceMarker en el punto donde cambia el formato. Cuando se llama a OnMarker , es seguro llamar a IMFSinkWriter::SetInputMediaType para cambiar el tipo de entrada (suponiendo que el receptor multimedia admita cambios de formato dinámico).

Internamente, este método llama a IMFStreamSink::P laceMarker en el receptor multimedia.

Nota El parámetro pvContext del método IMFSinkWriter::P laceMarker no se pasa al parámetro pvarContextValue del método IMFStreamSink::P laceMarker . Estos dos parámetros no están directamente relacionados.
 

Esta interfaz está disponible en Windows Vista si está instalado El complemento de actualización de la plataforma para Windows Vista.

Requisitos

Requisito Value
Cliente mínimo compatible Complemento de actualización de Windows 7, Windows Vista y plataforma para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado mfreadwrite.h

Consulte también

IMFSinkWriter

Escritor receptor