Método IKsInterfaceHandler::KsCompleteIo (ksproxy.h)

Artículo
08/07/2023

El método KsCompleteIo limpia los encabezados extendidos y libera ejemplos de medios una vez completada la entrada y salida (E/S).

Sintaxis

HRESULT KsCompleteIo(
  [in, out] PKSSTREAM_SEGMENT StreamSegment
);

Parámetros

[in, out] StreamSegment

Puntero a una estructura de KSSTREAM_SEGMENT que contiene información de encabezado para que se complete un segmento de secuencia.

Valor devuelto

Devuelve NOERROR si se ejecuta correctamente; de lo contrario, devuelve un código de error.

Comentarios

El método KsCompleteIo descarta la memoria asignada, actualiza los ejemplos de medios y disminuye el recuento de elementos de espera para el proxy.

El método KsCompleteIo debe determinar el tipo de operación de E/S que el método IKsInterfaceHandler::KsProcessMediaSamples se completó desde el miembro IoOperation de la estructura KSSTREAM_SEGMENT. Si la operación de E/S estaba leyendo datos de una secuencia (KsIoOperation_Read del tipo enumerado KSIOOPERATION), KsCompleteIo realiza las siguientes acciones para entregar el ejemplo desde un pin de salida al pin de entrada conectado:

Refleja la información del encabezado de secuencia en la interfaz IMediaSample .
Llama al método IKsPin::KsDeliver del pin de salida para entregar el ejemplo. KsDeliver libera el ejemplo para que, al poner en cola los búferes en el dispositivo, se puede recuperar el ejemplo si es el último ejemplo. A continuación, el pin de entrada completa la E/S y es seguro liberar el ejemplo.

Para obtener más información sobre IMediaSample, consulte la documentación de Microsoft Windows SDK.