Função KsRegisterAggregatedClientUnknown (ks.h)
De uma maneira muito semelhante à 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 para se tornar a interface desconhecida externa.
[in] ClientUnknown
Um ponteiro para uma interface IUnknown.
Valor de retorno
Retorna o objeto de agregação recém-criado.
Observações
O cliente desconhecido torna-se a parte interna do objeto agregado 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 |
|---|---|
| de cliente com suporte mínimo | Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no DirectX 8.0 e versões posteriores do DirectX. |
| da Plataforma de Destino | Universal |
| cabeçalho | ks.h (incluir Ks.h) |
| biblioteca | Ks.lib |
| IRQL | PASSIVE_LEVEL |
Consulte também
KsDeviceRegisterAggregatedClientUnknown
KsFilterFactoryRegisterAggregatedClientUnknown