IKsPin ::KsDeliver, méthode (ksproxy.h)
La méthode KsDeliver fournit un exemple de média à partir 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 allocator, puis 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 une énumération de masque de bits sur l’en-tête de flux de l’exemple de mé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 OptionsFlags membre de la description de la structure KSSTREAM_HEADER.
La connexion d’épingle vérifie l’indicateur de fin de flux (KSSTREAM_HEADER_OPTIONSF_ENDOFSTREAM) pour déterminer s’il doit fournir un événement de fin de flux une fois l’exemple terminé.
Valeur de retour
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 fournir un exemple multimé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 du Kit de développement logiciel (SDK) Microsoft Windows.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | ksproxy.h (include Ksproxy.h) |