Compartir a través de

Método IMFSourceReader::Flush (mfreadwrite.h)

  • Artículo

Vacía una o varias secuencias.

Sintaxis

HRESULT Flush(
  [in] DWORD dwStreamIndex
);

Parámetros

[in] dwStreamIndex

Secuencia que se va a vaciar. El valor puede ser cualquiera de los siguientes.

Valor Significado
0 a 0xFFFFFFFB
 Índice de base cero de una secuencia.
MF_SOURCE_READER_FIRST_VIDEO_STREAM
0xFFFFFFFC
 Primera secuencia de vídeo.
MF_SOURCE_READER_FIRST_AUDIO_STREAM
0xFFFFFFFD
 Primera secuencia de audio.
MF_SOURCE_READER_ALL_STREAMS
0xFFFFFFFE
 Todas las secuencias.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

El método Flush descarta todos los ejemplos en cola y cancela todas las solicitudes de ejemplo pendientes.

Este método puede completarse de forma sincrónica o asincrónica.

Si proporciona un puntero de devolución de llamada al crear el lector de origen, el método es asincrónico. De lo contrario, el método es sincrónico. Para obtener más información sobre la configuración del puntero de devolución de llamada, vea MF_SOURCE_READER_ASYNC_CALLBACK.

En modo sincrónico, el método se bloquea hasta que se completa la operación.

En modo asincrónico, se llama al método IMFSourceReaderCallback::OnFlush de la aplicación cuando se completa la operación de vaciado. Mientras una operación de vaciado está pendiente, el método IMFSourceReader::ReadSample devuelve MF_E_NOTACCEPTING.

Nota En Windows 7, se produjo un error en la implementación de este método, lo que hace que se llame a OnFlush antes de que se complete la operación de vaciado. Una revisión solía estar disponible que corrigió ese error.
 
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

IMFSourceReader

Lector de origen