KsFilterGetChildPinCount-Funktion (ks.h)
Die KsFilterGetChildPinCountFunktiongibt die Anzahl der Pins eines bestimmten Typs zurück, die derzeit in einem 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 instanziierter Pins vom Typ PinIDgefunden werden soll.
[in] PinId
Der Pintyp, für den die Anzahl instanziierter Pins gefunden werden soll. PinID- ist ein Index im 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 auf Filter-instanziiert werden. Wenn keine solchen Pins vorhanden sind oder PinID- außerhalb des Zulässigen liegt, wird Null zurückgegeben.
Bemerkungen
Die anzahl, die von diesem Aufruf zurückgegeben wird, ist garantiert nur korrekt, wenn die Funktion aufgerufen wird, während das Filtersteuerelement mutex gehalten wird. Die Anzahl bleibt nach dem Anruf korrekt, solange dieser Mutex weiterhin gehalten wird. Sobald der Mutex losgelassen 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 |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher directX-Versionen. |
| Zielplattform- | Universal |
| Header- | ks.h (enthalten Ks.h) |
| Library | Ks.lib |
| IRQL- | PASSIVE_LEVEL |