Funzione KsGetParent (ks.h)
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 oKSPIN. 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 |
Vedi anche
KsFilterFactoryGetParentDevice