Função KsRegisterAggregatedClientUnknown (ks.h)

  • Artigo

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

KsFilterRegisterAggregatedClientUnknown

KsGetOuterUnknown

KsPinRegisterAggregatedClientUnknown