befehl MCI_REALIZE

Der MCI_REALIZE-Befehl bewirkt, dass ein Grafikgerät seine Palette in einen Gerätekontext (DC) umsetzt. Digital-Videogeräte erkennen diesen Befehl.

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

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_REALIZE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GENERIC_PARMS) lpRealize
);

Parameter

wDeviceID

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

dwFlags

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

lpRealize

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

Sie sollten diesen Befehl verwenden, wenn Ihre Anwendung die WM_QUERYNEWPALETTE-Nachricht empfängt.

Die folgenden zusätzlichen Flags werden mit dem Gerätetyp "digitalvideo" verwendet:

MCI_DGV_REALIZE_BKGD

Realisiert die Palette als Hintergrundpalette.

MCI_DGV_REALIZE_NORM

Realisiert die Palette normal. Dies ist die Standardeinstellung.

Bei Digitalvideogeräten verweist der lpRealize-Parameter auf eine MCI_REALIZE_PARMS-Struktur . Weitere Informationen finden Sie unter Kommentare in der MCI_GENERIC_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