KsGetParent, fonction (ks.h)
La fonction KsGetParent acquiert le parent de l’objet donné.
Syntaxe
KSDDKAPI PVOID KsGetParent(
[in] PVOID Object
);
Paramètres
[in] Object
Pointeur vers l’objet AVStream pour lequel trouver le parent. Doit être un pointeur vers l’un des types suivants : KSDEVICE, KSFILTERFACTORY, KSFILTER ou KSPIN. Les appelants doivent taper manuellement l’objet sur un PVOID.
Valeur retournée
KsGetParent retourne le parent de Object en tant que PVOID. Les appelants doivent caster manuellement cette valeur de retour quel que soit le type du parent d’Object .
Remarques
Pour obtenir une représentation graphique des relations parent/enfant AVStream, consultez le diagramme dans hiérarchie d’objets AVStream.
La hiérarchie d’objets est garantie stable uniquement pendant que le mutex approprié est conservé, dans ce cas le mutex d’appareil. Pour plus d’informations, consultez Mutexes dans AVStream.
Les minidrivers utilisent rarement cette fonction directement. Les appelants de KsGetParent doivent effectuer manuellement des distributions de type vers et à partir de PVOID. Un certain nombre de versions inline effectuent le casting pour vous : KsFilterFactoryGetParentDevice, KsFilterGetParentFilterFactory et KsPinGetParentFilter.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Microsoft Windows XP et les systèmes d’exploitation ultérieurs et DirectX 8.0 et versions ultérieures de DirectX. |
| Plateforme cible | Universal |
| En-tête | ks.h (inclure Ks.h) |
| Bibliothèque | Ks.lib |
| IRQL | PASSIVE_LEVEL |
Voir aussi
KsFilterFactoryGetParentDevice