Funzione KsRegisterAggregatedClientUnknown (ks.h)

Articolo
08/07/2023

In modo molto simile a COM, la funzione KsRegisterAggregatedClientUnknown aggrega due oggetti: l'oggetto AVStream specificato e un oggetto sconosciuto client.

Sintassi

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

Parametri

[in] Object

Puntatore all'oggetto AVStream per diventare l'interfaccia sconosciuta esterna.

[in] ClientUnknown

Puntatore a un'interfaccia IUnknown .

Valore restituito

Restituisce l'oggetto aggregato appena creato.

Commenti

Il client sconosciuto diventa la parte interna dell'oggetto aggregato e l'oggetto AVStream diventa l'oggetto esterno sconosciuto. Quando viene eseguita una query su un'interfaccia che AVStream non gestisce, AVStream passa la query all'aggregazione interna.

Se un client sconosciuto è già aggregato nell'oggetto AVStream, AVStream rilascia l'aggregazione registrata in precedenza e usa l'sconosciuto passato a KsRegisterAggregatedClientUnknown come nuovo sconosciuto interno.

Sono disponibili quattro wrapper in KsRegisterAggregatedClientUnknown che eseguono typecast.

I minidriver non devono essere in esecuzione in un ambiente C++ per usare questa funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Microsoft Windows XP e versioni successive e DirectX 8.0 e versioni successive di DirectX.
Piattaforma di destinazione	Universale
Intestazione	ks.h (include Ks.h)
Libreria	Ks.lib
IRQL	PASSIVE_LEVEL