Metodo IKsInterfaceHandler::KsCompleteIo (ksproxy.h)

Il metodo KsCompleteIo pulisce le intestazioni estese e rilascia esempi multimediali al termine dell'input e dell'output (I/O).

Sintassi

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

Parametri

[in, out] StreamSegment

Puntatore a una struttura KSSTREAM_SEGMENT contenente le informazioni di intestazione per il completamento di un segmento di flusso.

Valore restituito

Restituisce NOERROR se l'operazione riesce; in caso contrario, restituisce un codice di errore.

Commenti

Il metodo KsCompleteIo elimina la memoria allocata, aggiorna gli esempi multimediali e decrementa il conteggio degli elementi di attesa per il proxy.

Il metodo KsCompleteIo deve determinare il tipo di operazione di I/O completata dal metodo IKsInterfaceHandler::KsProcessMediaSamples dal membro IoOperation della struttura KSSTREAM_SEGMENT. Se l'operazione di I/O legge i dati da un flusso (KsIoOperation_Read del tipo enumerato KSIOOPERATION), KsCompleteIo esegue le azioni seguenti per recapitare l'esempio da un pin di output al pin di input connesso:

• Riflette le informazioni sull'intestazione del flusso nell'interfaccia IMediaSample .
• Chiama il metodo IKsPin::KsDeliver del pin di output per recapitare l'esempio. KsDeliver rilascia l'esempio in modo che durante l'accodamento dei buffer nel dispositivo, l'esempio può essere recuperato se è l'ultimo esempio. Il pin di input completa quindi l'I/O ed è sicuro rilasciare l'esempio.

Per altre informazioni su IMediaSample, vedere la documentazione di Microsoft Windows SDK.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	ksproxy.h (include Ksproxy.h)

Vedi anche

IKsInterfaceHandler::KsProcessMediaSamples

IKsPin::KsDeliver

KSSTREAM_SEGMENT