ICGetState-Makro (vfw.h)

Das ICGetState-Makro fragt einen Videokomprimierungstreiber ab, um seine aktuelle Konfiguration in einem Speicherblock zurückzugeben. Sie können dieses Makro verwenden oder die ICM_GETSTATE Nachricht explizit aufrufen.

Syntax

DWORD ICGetState(
     hic,
     pv,
     cb
);

Die Parameter

hic

Griff des Kompressors.

pv

Zeigen Sie auf einen Speicherblock, der die aktuellen Konfigurationsinformationen enthält. Sie können NULL für diesen Parameter angeben, um den für die Konfigurationsinformationen erforderlichen Arbeitsspeicher zu bestimmen, wie in ICGetStateSize.

cb

Größe des Speicherblocks in Bytes.

Rückgabewert

Typ: DWORD-

Wenn PVNULL ist, gibt die Menge des Speichers in Bytes zurück, die für Konfigurationsinformationen erforderlich ist. Wenn Pv nicht NULL ist, wird ICERR_OK zurückgegeben, wenn dies erfolgreich ist oder andernfalls ein Fehler auftritt.

Bemerkungen

Das ICGetStateSize-Makro gibt die Anzahl der Bytes zurück, die von den Statusdaten verwendet werden.

Die Struktur, die zum Darstellen von Konfigurationsinformationen verwendet wird, ist treiberspezifisch und wird vom Treiber definiert.

Verwenden Sie ICGetStateSize , bevor Sie das ICGetState-Makro aufrufen, um die Größe des Puffers zu bestimmen, der für den Aufruf zugewiesen werden soll.

Anforderungen

Siehe auch

Videokomprimierungsmakros

Videokomprimierungs-Manager