Função KsPinGetCopyRelationships (ks.h)
A função KsPinGetCopyRelationships retorna informações de relação de cópia para um pin contido em um filtro centrado em pin .
Sintaxe
void KsPinGetCopyRelationships(
[in] PKSPIN Pin,
[out] PKSPIN *CopySource,
[out] PKSPIN *DelegateBranch
);
Parâmetros
[in] Pin
Um ponteiro para a estrutura KSPIN da qual você deseja adquirir informações de cópia.
[out] CopySource
Um ponteiro para um ponteiro para uma estrutura KSPIN que é a origem da cópia para Pin. Se Pin for a origem da cópia, a AVStream definirá esse parâmetro como NULL.
[out] DelegateBranch
Um ponteiro para um ponteiro para uma estrutura KSPIN que é o pino do qual Pin recebe quadros delegados. Se Pin for o delegador, a AVStream definirá esse parâmetro como NULL.
Retornar valor
Nenhum
Comentários
Os filtros centrados em filtro recebem informações semelhantes de CopySource e DelegateBranch quando o AVStream chama a função AVStrMiniFilterProcess do minidriver com uma matriz de estruturas de KSPROCESSPIN_INDEXENTRY.
A única diferença é que KsPinGetCopyRelationships retorna ponteiros para PKSPIN em vez de ponteiros para PKSPROCESSPIN. Para obter mais informações sobre os parâmetros CopySource e DelegateBranch , consulte AVStream Splitters.
Todos os pinos operam de forma independente no contexto de um filtro centrado em pin. Como resultado, um minidriver que chama KsPinGetCopyRelationships é responsável por garantir que a sincronização apropriada seja executada antes da hora da chamada.
Para garantir a segurança ao chamar KsPinGetCopyRelationships, obtenha o mutex de controle (não use esse mecanismo em uma expedição de processamento) ou verifique se o pino não faz a transição abaixo KSSTATE_PAUSE ao chamar ou usar as informações obtidas. Para obter mais informações sobre mutexes, consulte Mutexes no AVStream.
Para obter mais informações, consulte Processamento centrado em pin e processamento centrado em filtro.
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 |