Funzione KsGetNextSibling (ks.h)
La funzione KsGetNextSibling restituisce l'elemento di pari livello successivo di un oggetto specificato.
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 tale oggetto di pari livello non esiste, restituisce NULL.
Commenti
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 stabile solo quando il mutex appropriato viene mantenuto, in questo caso il mutex del dispositivo. Per altre informazioni, vedere Panoramica di AVStream e Mutexes 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, KsFilterGetNextSiblingFilter eKsPinGetNextSiblingPin.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Disponibile nei sistemi operativi Microsoft Windows XP e versioni successive e DirectX 8.0 e versioni successive di DirectX. |
Piattaforma di destinazione | Universale |
Intestazione | ks.h (include Ks.h) |
Libreria | Ks.lib |
IRQL | PASSIVE_LEVEL |