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.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | ksproxy.h (include Ksproxy.h) |