Funzione KsGetParent (ks.h)

Articolo
02/26/2024

La funzione KsGetParent acquisisce l'elemento padre dell'oggetto specificato.

Sintassi

KSDDKAPI PVOID KsGetParent(
  [in] PVOID Object
);

Parametri

[in] Object

Puntatore all'oggetto AVStream per il quale trovare l'elemento padre. Deve essere un puntatore a uno dei tipi seguenti: KSDEVICE, KSFILTERFACTORY, KSFILTER o KSPIN. I chiamanti devono digitare manualmente l'oggetto in un PVOID.

Valore restituito

KsGetParent restituisce l'elemento padre di Object come PVOID. I chiamanti devono eseguire manualmente il cast di questo valore restituito a qualsiasi tipo dell'elemento padre di Object .

Commenti

Per una rappresentazione grafica delle relazioni padre/figlio AVStream, vedere il diagramma nella gerarchia di oggetti AVStream.

La gerarchia degli oggetti è garantita solo stabile mentre il mutex appropriato viene mantenuto, in questo caso il mutex del dispositivo. Per altre informazioni, vedere Mutexes in AVStream.

I minidriver usano raramente questa funzione direttamente. I chiamanti di KsGetParent devono eseguire manualmente i typecast da e verso PVOID. Esistono diverse versioni inline che eseguono il cast: KsFilterFactoryGetParentDevice, KsFilterGetParentFilterFactory e KsPinGetParentFilterFilterFactory e KsPinGetParentFilter.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in 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