struttura KS_ANALOGVIDEOINFO (ksmedia.h)

Articolo
02/29/2024

La struttura KS_ANALOGVIDEOINFO descrive un flusso video analogico.

Sintassi

typedef struct tagKS_AnalogVideoInfo {
  RECT           rcSource;
  RECT           rcTarget;
  DWORD          dwActiveWidth;
  DWORD          dwActiveHeight;
  REFERENCE_TIME AvgTimePerFrame;
} KS_ANALOGVIDEOINFO, *PKS_ANALOGVIDEOINFO;

Members

rcSource

Specifica un rettangolo di ritaglio che seleziona la parte del segnale video attivo da usare.

rcTarget

Specifica un rettangolo che indica quale parte del buffer di destinazione utilizzare.

dwActiveWidth

Specifica la larghezza del segnale video in ingresso attivo. Ad esempio, il valore per ITUR-601 può essere impostato su 720 campioni attivi per riga.

dwActiveHeight

Specifica l'altezza del segnale video in ingresso attivo. Ad esempio, il valore per NTSC può essere impostato su 483. Per PAL/SECAM, il valore può essere impostato su 575.

AvgTimePerFrame

Specifica il tempo medio per fotogramma, in unità di 100 nanosecondi.

Commenti

Un filtro di origine può richiedere che il filtro sink richieda solo una sezione del video fornendo valori che definiscono in modo efficace un rettangolo di ritaglio nel membro rcSource . Tuttavia, se il filtro sink non controlla il rettangolo di ritaglio sulla connessione, il filtro sink esegue semplicemente il rendering di tutto il video, ignorando in modo efficace eventuali informazioni di ritaglio passate dal filtro di origine al filtro sink.

Idealmente, un filtro sink controlla rcSource. Se il filtro sink non supporta l'estrazione di immagini e il rettangolo non è vuoto, rifiuta la connessione. Un filtro deve usare la funzione Win32 SetRectEmpty per reimpostare un rettangolo su tutti gli zeri e impostare IsRectEmpty per controllare successivamente il rettangolo.

Il membro rcTarget specifica il rettangolo di destinazione per il video. La maggior parte dei filtri di origine imposta questo membro su tutti gli zeri. Un filtro downstream può richiedere che il video venga inserito in una determinata area dei buffer forniti. In questo caso, chiama la funzione Win32 QueryAccept con una destinazione non vuota.

Requisiti

Requisito	Valore
Intestazione	ksmedia.h (include Ksmedia.h)

Condividi tramite