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, KSFILTERo 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.
Osservazioni
Per una rappresentazione grafica delle relazioni padre/figlio AVStream, vedere il diagramma in gerarchia di oggetti AVStream.
La gerarchia di oggetti è garantita solo stabile mentre il mutex appropriato è 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, KsFilterGetParentFilterFactorye KsPinGetParentFilter.
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 |
Vedere anche
KsFilterFactoryGetParentDevice