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

Confira também

KSPIN_DESCRIPTOR_EX

KSPROCESSPIN