KsRegisterAggregatedClientUnknown, fonction (ks.h)

Article
02/29/2024

De manière très similaire à COM, la fonction KsRegisterAggregatedClientUnknown agrège deux objets : l’objet AVStream spécifié et un objet client inconnu.

Syntaxe

KSDDKAPI PUNKNOWN KsRegisterAggregatedClientUnknown(
  [in] PVOID    Object,
  [in] PUNKNOWN ClientUnknown
);

Paramètres

[in] Object

Pointeur vers l’objet AVStream pour devenir l’interface externe inconnue.

[in] ClientUnknown

Pointeur vers une interface IUnknown .

Valeur retournée

Retourne l’objet d’agrégation nouvellement créé.

Remarques

Le client inconnu devient la partie interne de l’objet d’agrégation et l’objet AVStream devient l’inconnu externe. Lorsqu’une interface est interrogée qu’AVStream ne gère pas, AVStream transmet la requête à l’agrégat interne.

Si un client inconnu est déjà agrégé sur l’objet AVStream, AVStream libère l’agrégat précédemment inscrit et utilise l’inconnu passé à KsRegisterAggregatedClientUnknown comme nouvelle inconnue interne.

KsRegisterAggregatedClientUnknown contient quatre wrappers qui effectuent des distributions de type.

Les minidrivers n’ont pas besoin d’être en cours d’exécution dans un environnement C++ pour utiliser cette fonction.

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