Funzione KsPinGetCopyRelationships (ks.h)
La funzione KsPinGetCopyRelationships restituisce informazioni sulla relazione di copia per un pin contenuto all'interno di un filtro incentrato sui pin .
Sintassi
void KsPinGetCopyRelationships(
[in] PKSPIN Pin,
[out] PKSPIN *CopySource,
[out] PKSPIN *DelegateBranch
);
Parametri
[in] Pin
Puntatore alla struttura KSPIN da cui si desidera acquisire informazioni di copia.
[out] CopySource
Puntatore a un puntatore a una struttura KSPIN che rappresenta l'origine di copia per Pin. Se Pin è l'origine di copia, AVStream imposta questo parametro su NULL.
[out] DelegateBranch
Puntatore a un puntatore a una struttura KSPIN che rappresenta il pin da cui Pin riceve fotogrammi delegati. Se Pin è il delegatore, AVStream imposta questo parametro su NULL.
Valore restituito
nessuno
Osservazioni
I filtri incentrati sui filtri ricevono informazioni simili su CopySource e DelegateBranch quando AVStream chiama la funzione AVStrMiniFilterProcess del minidriver con una matrice di strutture KSPROCESSPIN_INDEXENTRY .
L'unica differenza è che KsPinGetCopyRelationships restituisce puntatori a PKSPIN anziché puntatori a PKSPROCESSPIN. Per altre informazioni sui parametri CopySource e DelegateBranch , vedere Splitters AVStream.
Tutti i pin operano in modo indipendente nel contesto di un filtro incentrato sui pin. Di conseguenza, un minidriver che chiama KsPinGetCopyRelationships è responsabile di garantire che la sincronizzazione appropriata venga eseguita prima dell'ora di chiamata.
Per garantire la sicurezza quando si chiama KsPinGetCopyRelationships, ottenere il mutex del controllo (non usare questo meccanismo in un dispatch di elaborazione) oppure assicurarsi che il pin non passi sotto KSSTATE_PAUSE durante la chiamata o l'utilizzo delle informazioni ottenute. Per altre informazioni sui mutex, vedere Mutexes in AVStream.
Per altre informazioni, vedere Elaborazione basata sui pin e elaborazione basata sui filtri.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile nei sistemi operativi Microsoft Windows XP e versioni successive e DirectX 8.0 e versioni successive di DirectX. |
| Piattaforma di destinazione | Universale |
| Intestazione | ks.h (include Ks.h) |
| Libreria | Ks.lib |