Función KsPinGetCopyRelationships (ks.h)

  • Artículo

La función KsPinGetCopyRelationships devuelve información de relación de copia para un pin contenido en un filtro centrado en patillas .

Sintaxis

void KsPinGetCopyRelationships(
  [in]  PKSPIN Pin,
  [out] PKSPIN *CopySource,
  [out] PKSPIN *DelegateBranch
);

Parámetros

[in] Pin

Puntero a la estructura KSPIN desde la que desea adquirir información de copia.

[out] CopySource

Puntero a un puntero a una estructura KSPIN que es el origen de copia de Pin. Si Pin es el origen de copia, AVStream establece este parámetro en NULL.

[out] DelegateBranch

Puntero a un puntero a una estructura KSPIN que es el pin desde el que pin recibe fotogramas delegados. Si Pin es el delegado, AVStream establece este parámetro en NULL.

Valor devuelto

None

Observaciones

Los filtros centrados en filtros reciben información similar de CopySource y DelegateBranch cuando AVStream llama a la función AVStrMiniFilterProcess del minidriver con una matriz de estructuras de KSPROCESSPIN_INDEXENTRY .

La única diferencia es que KsPinGetCopyRelationships devuelve punteros a PKSPIN en lugar de punteros a PKSPROCESSPIN. Para obtener más información sobre los parámetros CopySource y DelegateBranch , vea AVStream Splitters.

Todas las patillas funcionan de forma independiente en el contexto de un filtro centrado en patillas. Como resultado, un minidriver que llama a KsPinGetCopyRelationships es responsable de garantizar que la sincronización adecuada se realice antes del tiempo de llamada.

Para garantizar la seguridad al llamar a KsPinGetCopyRelationships, obtenga la exclusión mutua de control (no use este mecanismo en un envío de procesamiento) o asegúrese de que el pin no realiza la transición por debajo de KSSTATE_PAUSE mientras llama a o usa la información obtenida. Para obtener más información sobre las exclusión mutuas, vea Exclusión mutua en AVStream.

Para obtener más información, consulte Procesamiento centrado en patillas y Procesamiento centrado en filtros.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Microsoft Windows XP y sistemas operativos posteriores y DirectX 8.0 y versiones posteriores de DirectX.
Plataforma de destino Universal
Encabezado ks.h (incluya Ks.h)
Library Ks.lib

Consulte también

KSPIN_DESCRIPTOR_EX

KSPROCESSPIN