KsFilterGetChildPinCount, fonction (ks.h)
La fonction KsFilterGetChildPinCountretourne le nombre de broches d’un type donné qui sont actuellement instanciées 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 de broche pour lequel rechercher le nombre de broches instanciées. PinID est un index dans le tableau de descripteurs de broche pour le filtre auquel appartient l’épingle.
Valeur retournée
KsFilterGetChildPinCount retourne le nombre de broches de type PinID qui sont actuellement instanciées sur Filter. Si ces broches n’existent pas ou si PinID est hors plage, zéro est retourné.
Remarques
Le nombre retourné par cet appel est garanti correct uniquement si la fonction est appelée pendant que le mutex du contrôle de filtre est maintenu. Le nombre reste correct après l’appel tant que ce mutex continue d’être maintenu. Dès que le mutex est libéré, d’autres broches peuvent être ajoutées ou supprimées, ce qui modifie le nombre réel de broches.
Pour plus d’informations, consultez Mutex dans AVStream.
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 |
| IRQL | PASSIVE_LEVEL |