befehl MCI_UNFREEZE

Der MCI_UNFREEZE-Befehl stellt die Bewegung in einem Bereich des Videopuffers wieder her, der mit dem Befehl MCI_FREEZE eingefroren wurde. Digitalvideo-, Videorekorder- und Videoüberlagerungsgeräte erkennen diesen Befehl.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_UNFREEZE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpUnfreeze
);

Parameter

wDeviceID

Gerätebezeichner des MCI-Geräts, das die Befehlsnachricht empfangen soll.

dwFlags

MCI_NOTIFY, MCI_WAIT oder für Digitalvideo- und Videorekordergeräte MCI_TEST. Informationen zu diesen Flags finden Sie unter Warte-, Benachrichtigungs- und Testflags.

lpUnfreeze

Zeiger auf eine MCI_GENERIC_PARMS-Struktur . (Geräte mit erweiterten Befehlssätzen können diese Struktur durch eine gerätespezifische Struktur ersetzen.)

Rückgabewert

Gibt null zurück, wenn der Vorgang erfolgreich war oder andernfalls ein Fehler.

Bemerkungen

Das folgende zusätzliche Flag wird für den Digitalvideo-Gerätetyp verwendet:

MCI_DGV_RECT

Das rc-Element der durch lpUnfreeze identifizierten Struktur enthält ein gültiges Anzeigerechteck. Das Rechteck gibt einen Bereich innerhalb des Framepuffers an, dessen Pixel das Sperrmaskenbit deaktiviert haben soll. Rechteckige Bereiche werden wie für den Befehl MCI_PUT beschrieben angegeben. Wenn es nicht angegeben wird, ist das Rechteck standardmäßig auf den gesamten Framepuffer festgelegt. Durch Die Verwendung einer Sequenz von Befehlen zum Einfrieren und Aufheben des Einfrierens mit verschiedenen Rechtecken können beliebige Muster von Sperrmaskenbits beschrieben werden.

Bei Digitalvideogeräten verweist der lpUnfreeze-Parameter auf eine MCI_DGV_UNFREEZE_PARMS-Struktur . Weitere Informationen finden Sie in den Kommentaren für die MCI_DGV_RECT_PARMS-Struktur .

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

MCI_VCR_UNFREEZE_INPUT

Heben Sie die Eingabe auf.

MCI_VCR_UNFREEZE_OUTPUT

Heben Sie das Einfrieren der Ausgabe auf.

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

MCI_OVLY_RECT

Das rc-Element der durch lpUnfreeze identifizierten Struktur enthält ein gültiges Anzeigerechteck. Dies ist ein erforderlicher Parameter.

Bei Videoüberlagerungsgeräten zeigt der lpUnfreeze-Parameter auf eine MCI_OVLY_RECT_PARMS-Struktur .

Anforderungen

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 (einschließlich Windows.h)

Siehe auch

MCI

MCI-Befehle