KsFilterGetChildPinCount, fonction (ks.h)
La fonction KsFilterGetChildPinCountretourne le nombre d’épingles d’un type donné actuellement instancié sur un filtre donné.
Syntaxe
KSDDKAPI ULONG KsFilterGetChildPinCount(
[in] PKSFILTER Filter,
[in] ULONG PinId
);
Paramètres
[in] Filter
Pointeur vers la structure KSFILTER pour laquelle rechercher le nombre de broches instanciées de type PinID.
[in] PinId
Type d’épingle pour lequel trouver le nombre de broches instanciées. PinID est un index dans le tableau de descripteurs de broche pour le filtre auquel appartient la broche.
Valeur de retour
KsFilterGetChildPinCount retourne le nombre de broches de type PinID actuellement instanciées sur filtre. S’il n’existe pas de broches de ce type ou si pinID est hors limites, zéro est retourné.
Remarques
Le nombre retourné par cet appel est garanti uniquement si la fonction est appelée pendant que le mutex de contrôle de filtre est conservé. Le nombre reste correct après l’appel tant que ce mutex continue d’être conservé. Dès que le mutex est libéré, d’autres broches peuvent être ajoutées ou supprimées, modifiant ainsi le nombre réel de broches.
Pour plus d’informations, consultez Mutexes dans AVStream.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum 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 | Universel |
| d’en-tête | ks.h (include Ks.h) |
| bibliothèque | Ks.lib |
| IRQL | PASSIVE_LEVEL |