Función KsPinGetCopyRelationships (ks.h)
La función KsPinGetCopyRelationships devuelve información de relación de copia para un pin contenido dentro de un filtro de 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 un estructura de 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 un estructura de KSPIN del que pin recibe fotogramas delegados. Si pin es el delegado, AVStream establece este parámetro en NULL.
Valor devuelto
Ninguno
Observaciones
los filtros de centrados en filtros reciben CopySource y información 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, consulte .
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 Pin-Centric Procesamiento de y procesamiento de Filter-Centric.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Microsoft Windows XP y sistemas operativos posteriores y DirectX 8.0 y versiones posteriores de DirectX. |
| de la plataforma de destino de | Universal |
| encabezado de | ks.h (incluya Ks.h) |
| biblioteca de | Ks.lib |