COMPVARS-Struktur (vfw.h)

Die COMPVARS-Struktur beschreibt Kompressoreinstellungen für Funktionen wie ICCompressorChoose, ICSeqCompressFrame und ICCompressorFree.

Syntax

typedef struct {
  LONG         cbSize;
  DWORD        dwFlags;
  HIC          hic;
  DWORD        fccType;
  DWORD        fccHandler;
  LPBITMAPINFO lpbiIn;
  LPBITMAPINFO lpbiOut;
  LPVOID       lpBitsOut;
  LPVOID       lpBitsPrev;
  LONG         lFrame;
  LONG         lKey;
  LONG         lDataRate;
  LONG         lQ;
  LONG         lKeyCount;
  LPVOID       lpState;
  LONG         cbState;
} COMPVARS, *PCOMPVARS;

Member

cbSize

Größe dieser Struktur in Bytes. Dieses Element muss so festgelegt werden, dass die Struktur überprüft wird, bevor eine Funktion mit dieser Struktur aufgerufen wird.

dwFlags

Anwendbare Flags. Der folgende Wert wird definiert:

Name	BESCHREIBUNG
ICMF_COMPVARS_VALID	Daten in dieser Struktur sind gültig und wurden manuell eingegeben. Legen Sie dieses Flag fest, bevor Sie eine Funktion aufrufen, wenn Sie diese Struktur manuell ausfüllen. Legen Sie dieses Flag nicht fest, wenn Sie ICCompressorChoose diese Struktur initialisieren lassen.

hic

Griff zum zu verwendenden Kompressor. Sie können einen Kompressor öffnen und einen Griff davon erhalten, indem Sie die ICOpen-Funktion verwenden. Sie können auch einen Kompressor auswählen, indem Sie ICCompressorChoose verwenden. ICCompressorChoose öffnet den ausgewählten Kompressor und gibt den Griff des Kompressors in diesem Element zurück. Sie können den Kompressor mit ICCompressorFree schließen.

fccType

Typ des verwendeten Kompressors. Derzeit wird nur ICTYPE_VIDEO (VIDC) unterstützt. Dieses Element kann auf 0 festgelegt werden.

fccHandler

Vierzeichencode des Kompressors. Geben Sie NULL an, um anzugeben, dass die Daten nicht erneut komprimiert werden sollen. Geben Sie "DIB" an, um anzugeben, dass es sich bei den Daten um einen nicht komprimierten, vollständigen Frame handelt. Sie können dieses Element verwenden, um anzugeben, welcher Kompressor standardmäßig ausgewählt ist, wenn das Dialogfeld angezeigt wird.

lpbiIn

Reserviert; nicht verwenden.

lpbiOut

Zeiger auf eine BITMAPINFO-Struktur , die das Bildausgabeformat enthält. Sie können ein bestimmtes zu verwendende Format angeben oder NULL angeben, um den Standardkompressor zu verwenden, der dem Eingabeformat zugeordnet ist. Sie können das Bildausgabeformat auch mithilfe von ICCompressorChoose festlegen.

lpBitsOut

Reserviert; nicht verwenden.

lpBitsPrev

Reserviert; nicht verwenden.

lFrame

Reserviert; nicht verwenden.

lKey

Key-Frame-Rate. Geben Sie eine ganze Zahl an, um die Häufigkeit anzugeben, mit der Keyframes in der komprimierten Sequenz auftreten sollen, oder null, um keine Keyframes zu verwenden. Sie können icCompressorChoose auch die im Dialogfeld ausgewählte Key-Frame-Rate festlegen lassen. Die ICSeqCompressFrameStart-Funktion verwendet den Wert dieses Members zum Erstellen von Keyframes.

lDataRate

Datenrate in Kilobyte pro Sekunde. ICCompressorChoose kopiert die ausgewählte Datenrate aus dem Dialogfeld in dieses Element.

lQ

Qualitätseinstellung. Geben Sie eine Qualitätseinstellung von 1 bis 10.000 an, oder geben Sie an, ICQUALITY_DEFAULT die Standardqualitätseinstellung verwenden soll. Sie können icCompressorChoose auch den im Dialogfeld ausgewählten Qualitätswert festlegen lassen. ICSeqCompressFrameStart verwendet den Wert dieses Members als Qualitätseinstellung.

lKeyCount

Reserviert; nicht verwenden.

lpState

Reserviert; nicht verwenden.

cbState

Reserviert; nicht verwenden.

Hinweise

Sie können ICCompressorChoose den Inhalt dieser Struktur füllen oder manuell ausführen. Wenn Sie die Struktur manuell ausfüllen, müssen Sie Informationen für die folgenden Member bereitstellen: cbSize, hic, lpbiOut, lKey und lQ. Außerdem müssen Sie das ICMF_COMPVARS_VALID-Flag im dwFlags-Element festlegen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	vfw.h

Weitere Informationen

ICCompressorChoose

ICCompressorFree

ICSeqCompressFrame

ICSeqCompressFrameStart

Videokomprimierungs-Manager

Videokomprimierungsstrukturen