KsFilterGetChildPinCount-Funktion (ks.h)
Die KsFilterGetChildPinCount-Funktiongibt die Anzahl der Pins eines bestimmten Typs zurück, die derzeit für einen bestimmten Filter instanziiert werden.
Syntax
KSDDKAPI ULONG KsFilterGetChildPinCount(
[in] PKSFILTER Filter,
[in] ULONG PinId
);
Parameter
[in] Filter
Ein Zeiger auf die KSFILTER-Struktur , für die die Anzahl der instanziierten Pins vom Typ PinID ermittelt werden soll.
[in] PinId
Der Pintyp, für den die Anzahl der instanziierten Pins ermittelt werden soll. PinID ist ein Index in das Array von Pindeskriptoren für den Filter, zu dem der Pin gehört.
Rückgabewert
KsFilterGetChildPinCount gibt die Anzahl der Pins vom Typ PinID zurück, die derzeit für Filter instanziiert werden. Wenn keine solchen Pins vorhanden sind oder sich PinID außerhalb des Bereichs befindet, wird null zurückgegeben.
Hinweise
Die anzahl, die von diesem Aufruf zurückgegeben wird, ist nur dann richtig, wenn die Funktion aufgerufen wird, während das Filtersteuerelement-Mutex gehalten wird. Die Anzahl bleibt nach dem Anruf richtig, solange dieser Mutex weiterhin gehalten wird. Sobald der Mutex freigegeben wird, können andere Pins hinzugefügt oder entfernt werden, wodurch die tatsächliche Pinanzahl geändert wird.
Weitere Informationen finden Sie unter Mutexes in AVStream.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher DirectX-Versionen. |
| Zielplattform | Universell |
| Header | ks.h (einschließlich Ks.h) |
| Bibliothek | Ks.lib |
| IRQL | PASSIVE_LEVEL |