Expand Minimize

KsRegisterAggregatedClientUnknown function

In a manner very similar to COM, the KsRegisterAggregatedClientUnknown function aggregates two objects: the specified AVStream object and a client unknown object.

Syntax


PUNKNOWN KsRegisterAggregatedClientUnknown(
  _In_  PVOID    Object,
  _In_  PUNKNOWN ClientUnknown
);

Parameters

Object [in]

A pointer to the AVStream object to become the outer unknown interface.

ClientUnknown [in]

A pointer to an IUnknown interface.

Return value

Returns the newly created aggregate object.

Remarks

The client unknown becomes the inner part of the aggregate object, and the AVStream object becomes the outer unknown. When an interface is queried that AVStream does not handle, AVStream passes the query is to the inner aggregate.

If a client unknown is already aggregated on the AVStream object, AVStream releases the previously registered aggregate and uses the unknown passed to KsRegisterAggregatedClientUnknown as the new inner unknown.

There are four wrappers to KsRegisterAggregatedClientUnknown that perform typecasts.

Minidrivers do not need to be running in a C++ environment to use this function.

Requirements

Target platform

Universal

Version

Available in Microsoft Windows XP and later operating systems and DirectX 8.0 and later DirectX versions.

Header

Ks.h (include Ks.h)

Library

Ks.lib

IRQL

PASSIVE_LEVEL

See also

KsDeviceRegisterAggregatedClientUnknown
KsFilterFactoryRegisterAggregatedClientUnknown
KsFilterRegisterAggregatedClientUnknown
KsPinRegisterAggregatedClientUnknown
KsGetOuterUnknown

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft