Funzione KsGetNextSibling (ks.h)

Articolo
02/26/2024

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 e KsPinGetNextSiblingPin.

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