befehl "MCI_FREEZE"

Der MCI_FREEZE Befehl friert die Bewegung auf dem Display ein. Digital-Video-, Videoüberlagerungs- und Videorekordergeräte erkennen diesen Befehl.

Um diesen Befehl zu senden, rufen Sie die mciSendCommand-Funktion mit den folgenden Parametern auf.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_FREEZE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpFreeze
);

Parameter

wDeviceID: Geräte-ID des MCI-Geräts, das die Befehlsnachricht empfangen soll.
dwFlags: MCI_NOTIFY, MCI_WAIT oder MCI_TEST für digitale Video- und Videorekordergeräte. Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.
lpFreeze: Zeiger auf eine MCI_GENERIC_PARMS-Struktur . (Geräte mit zusätzlichen Parametern können diese Struktur durch eine gerätespezifische Struktur ersetzen.)

Gibt null zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt.

Die folgenden zusätzlichen Flags werden vom Digitalvideo-Gerätetyp verwendet:

MCI_DGV_FREEZE_AT: Der rc-Member der von lpFreeze identifizierten Struktur enthält ein gültiges Rechteck. Das Rechteck gibt einen Bereich innerhalb des Framepuffers an, in dem das Sperrmaskenbit für jedes Pixel aktiviert ist. Die angegebenen Pixel werden erst aktualisiert, wenn das Sperrmaskenbit deaktiviert ist. Wenn dieses Flag nicht angegeben ist, wird für das Rechteck standardmäßig der gesamte Framepuffer verwendet. Dieses Flag wird nur unterstützt, wenn der befehl MCI_GETDEVCAPS für das flag MCI_DGV_GETDEVCAPS_CAN_LOCK true zurückgibt.
MCI_DGV_FREEZE_OUTSIDE: Der Bereich außerhalb des für das flag MCI_DGV_FREEZE_AT angegebenen Bereichs wird eingefroren.

Bei Digital-Video-Geräten verweist der parameter lpFreeze auf eine MCI_DGV_FREEZE_PARMS-Struktur .

Die folgenden zusätzlichen Flags werden vom Vcr-Gerätetyp verwendet:

MCI_VCR_FREEZE_FIELD: Fixieren Sie nur einen Member des aktuellen Frames.
MCI_VCR_FREEZE_FRAME: Frieren Sie beide Felder des aktuellen Frames ein.
MCI_VCR_FREEZE_INPUT: Fixieren sie den aktuellen Frame auf dem Bildschirm (wird für die Aufzeichnung verwendet).
MCI_VCR_FREEZE_OUTPUT: Fixieren sie den aktuellen Frame aus dem Videorecorder (verwendet mit frame capture).

Bei VcR-Geräten verweist der parameter lpFreeze auf eine MCI_GENERIC_PARMS-Struktur .

Das folgende zusätzliche Flag wird vom Überlagerungsgerätetyp verwendet:

MCI_OVLY_RECT: Der rc-Member der von lpFreeze identifizierten Struktur enthält ein gültiges Rechteck. Wenn dieses Flag nicht angegeben ist, friert der Gerätetreiber den gesamten Frame ein.

Bei Videoüberlagerungsgeräten verweist der parameter lpFreeze auf eine MCI_OVLY_RECT_PARMS-Struktur .

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Mmsystem.h (windows.h einschließen)