Funzione KsGetNextSibling (ks.h)
La funzione KsGetNextSibling restituisce l'elemento di pari livello successivo di un determinato oggetto.
Sintassi
KSDDKAPI PVOID KsGetNextSibling(
[in] PVOID Object
);
Parametri
[in] Object
Oggetto per il quale trovare l'elemento di pari livello successivo.
Valore restituito
KsGetNextSibling restituisce l'oggetto di pari livello successivo di Object. Se non esiste alcun oggetto di pari livello di questo tipo, restituisce NULL.
Osservazioni
Se Object è una factory di filtro, KsGetNextSibling restituisce la factory di filtro successiva appartenente al dispositivo padre e così via. I chiamanti devono eseguire il typecasting appropriato da e verso PVOID.
La gerarchia degli oggetti è garantita solo se il mutex appropriato è mantenuto, in questo caso il mutex del dispositivo. Per altre informazioni, vedere panoramica AVStream e mutex in AVStream.
I minidriver chiamano raramente KsGetNextSibling direttamente. Esistono diverse funzioni che sono chiamate inline a KsGetNextSibling e che eseguono il typecasting per l'utente: KsFilterFactoryGetNextSiblingFilterFactory, KsFilterGetNextSiblingFiltere KsPinGetNextSiblingPin.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Microsoft Windows XP e nei sistemi operativi successivi e in DirectX 8.0 e versioni successive di DirectX. |
| piattaforma di destinazione | Universale |
| intestazione | ks.h (include Ks.h) |
| libreria | Ks.lib |
| IRQL | PASSIVE_LEVEL |