Metodo IKsPin::KsDeliver (ksproxy.h)

Il metodo KsDeliver fornisce un campione multimediale da un pin di output a un pin di input, continua un'operazione di I/O recuperando il buffer successivo da un allocatore e invia il buffer al dispositivo associato.

Sintassi

HRESULT KsDeliver(
  [in] IMediaSample *Sample,
  [in] ULONG        Flags
);

Parametri

[in] Sample

Puntatore all'interfaccia IMediaSample per l'esempio multimediale associato.

[in] Flags

Specifica una maschera di bit che enumera informazioni sull'intestazione del flusso dell'esempio multimediale. È possibile una combinazione OR bit per bit dei flag seguenti:

KSSTREAM_HEADER_OPTIONSF_SPLICEPOINT

KSSTREAM_HEADER_OPTIONSF_PREROLL

KSSTREAM_HEADER_OPTIONSF_DATADISCONTINUITY

KSSTREAM_HEADER_OPTIONSF_TYPECHANGED

KSSTREAM_HEADER_OPTIONSF_TIMEVALID

KSSTREAM_HEADER_OPTIONSF_TIMEDISCONTINUITY

KSSTREAM_HEADER_OPTIONSF_FLUSHONPAUSE

KSSTREAM_HEADER_OPTIONSF_DURATIONVALID

KSSTREAM_HEADER_OPTIONSF_ENDOFSTREAM

KSSTREAM_HEADER_OPTIONSF_LOOPEDDATA

Questi flag sono definiti nel membro OptionsFlags della descrizione della struttura KSSTREAM_HEADER .

La connessione pin verifica la presenza del flag end-of-stream (KSSTREAM_HEADER_OPTIONSF_ENDOFSTREAM) per determinare se deve recapitare un evento end-of-stream al termine dell'esempio.

Valore restituito

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

Commenti

Un gestore di interfaccia (IKsInterfaceHandler) chiama KsDeliver sul pin di output di un filtro per recapitare un campione multimediale al pin di input di un altro filtro. Questi pin di input e di output sono connessi.

Per un pin di input, KsDeliver è un punto di ingresso non valido e restituisce EFAIL.

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

IKsInterfaceHandler::KsCompleteIo