Méthode IKsPin ::KsDeliver (ksproxy.h)
La méthode KsDeliver fournit un exemple de média d’une broche de sortie à une broche d’entrée, poursuit une opération d’E/S en récupérant la mémoire tampon suivante à partir d’un allocateur et envoie la mémoire tampon à l’appareil associé.
Syntaxe
HRESULT KsDeliver(
[in] IMediaSample *Sample,
[in] ULONG Flags
);
Paramètres
[in] Sample
Pointeur vers l’interface IMediaSample pour l’exemple de média associé.
[in] Flags
Spécifie un masque de bits énumérant des informations sur l’en-tête de flux de l’exemple multimédia. Une combinaison OR au niveau du bit des indicateurs suivants est possible :
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
Ces indicateurs sont définis dans le membre OptionsFlags de la description de la structure KSSTREAM_HEADER .
La connexion de broche recherche l’indicateur de fin de flux (KSSTREAM_HEADER_OPTIONSF_ENDOFSTREAM) pour déterminer si elle doit remettre un événement de fin de flux une fois l’exemple terminé.
Valeur retournée
Retourne NOERROR en cas de réussite ; sinon, retourne un code d’erreur.
Remarques
Un gestionnaire d’interface (IKsInterfaceHandler) appelle KsDeliver sur la broche de sortie d’un filtre pour remettre un exemple de média à la broche d’entrée d’un autre filtre. Ces broches d’entrée et de sortie sont connectées.
Pour une broche d’entrée, KsDeliver est un point d’entrée non valide et retourne EFAIL.
Pour plus d’informations sur IMediaSample, consultez la documentation Microsoft Windows SDK.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | ksproxy.h (inclure Ksproxy.h) |