Função KsRegisterAggregatedClientUnknown (ks.h)
De maneira muito semelhante ao COM, a função KsRegisterAggregatedClientUnknown agrega dois objetos: o objeto AVStream especificado e um objeto desconhecido do cliente.
Sintaxe
KSDDKAPI PUNKNOWN KsRegisterAggregatedClientUnknown(
[in] PVOID Object,
[in] PUNKNOWN ClientUnknown
);
Parâmetros
[in] Object
Um ponteiro para o objeto AVStream se tornar a interface desconhecida externa.
[in] ClientUnknown
Um ponteiro para uma interface IUnknown.
Retornar valor
Retorna o objeto de agregação recém-criado.
Comentários
O cliente desconhecido torna-se a parte interna do objeto de agregação e o objeto AVStream torna-se o desconhecido externo. Quando uma interface é consultada que o AVStream não manipula, o AVStream passa a consulta para a agregação interna.
Se um cliente desconhecido já estiver agregado no objeto AVStream, o AVStream liberará a agregação registrada anteriormente e usará o desconhecido passado para KsRegisterAggregatedClientUnknown como o novo desconhecido interno.
Há quatro wrappers para KsRegisterAggregatedClientUnknown que executam typecasts.
Os minidrivers não precisam estar em execução em um ambiente C++ para usar essa função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no DirectX 8.0 e versões posteriores do DirectX. |
| Plataforma de Destino | Universal |
| Cabeçalho | ks.h (inclua Ks.h) |
| Biblioteca | Ks.lib |
| IRQL | PASSIVE_LEVEL |
Confira também
KsDeviceRegisterAggregatedClientUnknown
KsFilterFactoryRegisterAggregatedClientUnknown