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 da cui Pin riceve fotogrammi delegati. Se Pin è delegato, AVStream imposta questo parametro su NULL.
Valore restituito
Nessuno
Osservazioni
filtri incentrati sul filtro ricevono informazioni simili 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 .
Tutti i pin operano indipendentemente 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 al di sotto del KSSTATE_PAUSE durante la chiamata o l'uso delle informazioni ottenute. Per altre informazioni sui mutex, vedere Mutexes in AVStream.
Per altre informazioni, vedere Pin-Centric Processing e Filter-Centric Processing.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Microsoft Windows XP e nei sistemi operativi successivi e in DirectX 8.0 e versioni successive di DirectX. |
| piattaforma di destinazione | Universale |
| intestazione | ks.h (include Ks.h) |
| libreria | Ks.lib |