KS_VIDEOINFOHEADER struttura (ksmedia.h)

La struttura KS_VIDEOINFOHEADER descrive le informazioni di bitmap e colore per un flusso video.

Sintassi

typedef struct tagKS_VIDEOINFOHEADER {
  RECT                rcSource;
  RECT                rcTarget;
  DWORD               dwBitRate;
  DWORD               dwBitErrorRate;
  REFERENCE_TIME      AvgTimePerFrame;
  KS_BITMAPINFOHEADER bmiHeader;
} KS_VIDEOINFOHEADER, *PKS_VIDEOINFOHEADER;

Members

rcSource

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

rcTarget

Specifica un rettangolo che definisce la finestra video di destinazione.

dwBitRate

Specifica un valore che indica la frequenza di dati approssimativa del flusso video, in bit al secondo.

dwBitErrorRate

Specifica un valore che indica la frequenza di errore dei dati del flusso video, in errori di bit al secondo.

AvgTimePerFrame

Specifica il tempo medio per fotogramma, in 100-nanosecondi.

bmiHeader

Descrive una struttura KS_BITMAPINFOHEADER che contiene informazioni sul colore e la dimensione sulla bitmap dell'immagine video.

Commenti

Per descrivere un flusso video con impostazioni bob o weave, usare KS_VIDEOINFOHEADER2.

La struttura KS_VIDEOINFOHEADER è identica alla struttura MICROSOFT DirectShow VIDEOINFOHEADER.

Un filtro di origine può richiedere che il filtro sink prenda 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 verifica la presenza del rettangolo di ritaglio sulla connessione, il filtro sink esegue semplicemente il rendering di tutti i video, ignorando in modo efficace eventuali informazioni di ritaglio passate dal filtro di origine al filtro sink.

Idealmente, un filtro sink controlla rcSource e se il filtro sink non supporta l'estrazione di immagini e il rettangolo non è vuoto, quindi rifiuta la connessione. Un filtro deve usare la funzione Win32 SetRectEmpty per reimpostare un rettangolo su tutti gli zero (e impostare IsRectEmpty per controllare più avanti 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 zero. Un filtro downstream può richiedere che il video venga inserito in un'area specifica dei buffer forniti. In questo caso, chiama la funzione Win32 QueryAccept con una destinazione non interrotta.

Requisiti

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

Vedi anche

KS_BITMAPINFOHEADER

KS_VIDEOINFOHEADER2