KsPinGetCopyRelationships, fonction (ks.h)
La fonction KsPinGetCopyRelationships retourne les informations de relation de copie pour une broche contenue dans un filtre centré sur les broches .
Syntaxe
void KsPinGetCopyRelationships(
[in] PKSPIN Pin,
[out] PKSPIN *CopySource,
[out] PKSPIN *DelegateBranch
);
Paramètres
[in] Pin
Pointeur vers la structure KSPIN à partir de laquelle vous souhaitez acquérir des informations de copie.
[out] CopySource
Pointeur vers un pointeur vers une structure KSPIN qui est la source de copie pour Pin. Si Pin est la source de copie, AVStream définit ce paramètre sur NULL.
[out] DelegateBranch
Pointeur vers un pointeur vers une structure KSPIN qui est la broche à partir de laquelle Pin reçoit des images déléguées. Si Pin est le délégant, AVStream définit ce paramètre sur NULL.
Valeur de retour
None
Remarques
Les filtres centrés sur les filtres reçoivent des informations CopySource et DelegateBranch similaires quand AVStream appelle la fonction AVStrMiniFilterProcess du minidriver avec un tableau de structures KSPROCESSPIN_INDEXENTRY.
La seule différence est que KsPinGetCopyRelationships retourne des pointeurs vers PKSPIN plutôt que des pointeurs vers PKSPROCESSPIN. Pour plus d’informations sur les paramètres CopySource et DelegateBranch , consultez Splitters AVStream.
Toutes les broches fonctionnent indépendamment dans le contexte d’un filtre centré sur les broches. Par conséquent, un minidriver qui appelle KsPinGetCopyRelationships est chargé de s’assurer que la synchronisation appropriée est effectuée avant l’heure de l’appel.
Pour garantir la sécurité lors de l’appel de KsPinGetCopyRelationships, obtenez le mutex de contrôle (n’utilisez pas ce mécanisme dans une distribution de traitement) ou assurez-vous que la broche ne passe pas sous KSSTATE_PAUSE lors de l’appel ou de l’utilisation des informations obtenues. Pour plus d’informations sur les mutex, consultez Mutexes dans AVStream.
Pour plus d’informations, consultez Traitement centré sur les épingles et Traitement centré sur les filtres.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Microsoft Windows XP et les systèmes d’exploitation ultérieurs et DirectX 8.0 et versions ultérieures de DirectX. |
| Plateforme cible | Universal |
| En-tête | ks.h (inclure Ks.h) |
| Bibliothèque | Ks.lib |