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

Artigo
02/29/2024

O método KsCompleteIo limpa cabeçalhos estendidos e libera amostras de mídia após a conclusão da E/S (entrada e saída).

Sintaxe

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

Parâmetros

[in, out] StreamSegment

Ponteiro para uma estrutura KSSTREAM_SEGMENT que contém informações de cabeçalho para um segmento de fluxo a ser concluído.

Retornar valor

Retornará NOERROR se tiver êxito; caso contrário, retorna um código de erro.

Comentários

O método KsCompleteIo descarta a memória alocada, atualiza exemplos de mídia e diminui a contagem de itens de espera para o proxy.

O método KsCompleteIo deve determinar o tipo de operação de E/S que o método IKsInterfaceHandler::KsProcessMediaSamples concluiu do membro IoOperation da estrutura KSSTREAM_SEGMENT. Se a operação de E/S estava lendo dados de um fluxo (KsIoOperation_Read do tipo enumerado KSIOOPERATION), o KsCompleteIo executa as seguintes ações para entregar o exemplo de um pino de saída para o pin de entrada conectado:

Reflete as informações de cabeçalho de fluxo na interface IMediaSample .
Chama o método IKsPin::KsDeliver do pino de saída para entregar o exemplo. KsDeliver libera o exemplo para que, ao enfileirar buffers para o dispositivo, o exemplo possa ser recuperado se for o último exemplo. Em seguida, o pino de entrada conclui a E/S e é seguro liberar o exemplo.

Para obter mais informações sobre IMediaSample, consulte a documentação do SDK do Microsoft Windows.