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 rechercher le parent. Doit être un pointeur vers l’un des types suivants : KSDEVICE , KSFILTERFACTORY, KSFILTERou KSPIN. Les appelants doivent taper manuellement l’objet sur un PVOID.
Valeur de retour
KsGetParent retourne le parent de Object en tant que PVOID. Les appelants doivent convertir manuellement cette valeur de retour en fonction du type du parent de 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 de l’appareil. Pour plus d’informations, consultez Mutexes dans AVStream.
Les minidrivers utilisent rarement cette fonction directement. Les appelants de KsGetParent doivent effectuer manuellement des typescast vers et à partir de PVOID. Il existe un certain nombre de versions inline qui effectuent le cast pour vous : KsFilterFactoryGetParentDevice, KsFilterGetParentFilterFactoryet KsPinGetParentFilter.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum 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 | Universel |
| d’en-tête | ks.h (include Ks.h) |
| bibliothèque | Ks.lib |
| IRQL | PASSIVE_LEVEL |
Voir aussi
KsFilterFactoryGetParentDevice