Partager via


KsGetFirstChild, fonction (ks.h)

La fonction KsGetFirstChild retourne le premier objet enfant AVStream de Object.

Syntaxe

KSDDKAPI PVOID KsGetFirstChild(
  [in] PVOID Object
);

Paramètres

[in] Object

Objet pour lequel trouver le premier objet enfant AVStream.

Valeur retournée

KsGetFirstChild retourne le premier objet enfant AVStream d’Object. S’il n’existe aucun objet enfant de ce type, il retourne NULL.

Remarques

Pour afficher la organization hiérarchique des objets AVStream, consultez Hiérarchie d’objets AVStream.

Les minidrivers appellent rarement cette fonction directement. Ceux qui le font doivent effectuer manuellement des casts de type vers et à partir de PVOID. Un certain nombre de fonctions sont des appels inline à KsGetFirstChild et effectuent des diffusions de type pour vous : KsDeviceGetFirstChildFilterFactory et KsFilterFactoryGetFirstChildFilter. Notez que la hiérarchie d’objets est garantie stable uniquement pendant que le mutex approprié est maintenu, dans ce cas, le mutex de l’appareil. Pour plus d’informations, consultez Mutex dans AVStream.

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

KsDeviceGetFirstChildFilterFactory

KsFilterFactoryGetFirstChildFilter

KsFilterGetFirstChildPin

KsGetParent