Metodo IKsInterfaceHandler::KsCompleteIo (ksproxy.h)

Articolo
02/07/2025

Il metodo KsCompleteIo pulisce le intestazioni estese e rilascia campioni 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 che contiene informazioni di intestazione per il completamento di un segmento di flusso.

Valore restituito

Restituisce NOERROR se ha esito positivo; in caso contrario, restituisce un codice di errore.

Osservazioni

Il metodo KsCompleteIo elimina la memoria allocata, aggiorna gli esempi multimediali e decrementa il numero di 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 stava leggendo 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.