Método IKsInterfaceHandler::KsCompleteIo (ksproxy.h)
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 de KSSTREAM_SEGMENT que contém informações de cabeçalho para que um segmento de fluxo seja concluído.
Valor de retorno
Retorna NOERROR se bem-sucedido; caso contrário, retorna um código de erro.
Observações
O método KsCompleteIo descarta 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 concluído do membro de IoOperation da estrutura KSSTREAM_SEGMENT. Se a operação de E/S estava lendo dados de um fluxo (KsIoOperation_Read do tipo enumerado KSIOOPERATION), KsCompleteIo executará as seguintes ações para entregar o exemplo de um pino de saída para o pin de entrada conectado:
- Reflete as informações do cabeçalho de fluxo na interface de 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 no 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.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | ksproxy.h (inclua Ksproxy.h) |