Metodo IKsPin::KsDeliver (ksproxy.h)
Il metodo KsDeliver fornisce un esempio 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 nella OptionsFlags membro 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 ha esito positivo; in caso contrario, restituisce un codice di errore.
Osservazioni
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 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.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | ksproxy.h (include Ksproxy.h) |