realize-Befehl

Der Befehl realize weist ein Gerät an, seine Palette im Anzeigekontext des angezeigten Fensters auszuwählen und zu realisieren. Digitalvideogeräte erkennen diesen Befehl.

Um diesen Befehl zu senden, rufen Sie die mciSendString-Funktion mit dem lpszCommand-Parameter auf, der wie folgt festgelegt ist.

_stprintf_s(
  lpszCommand, 
  TEXT("realize %s %s %s"), 
  lpszDeviceID, 
  lpszPalette, 
  lpszFlags
); 

Parameter

lpszDeviceID

Bezeichner eines MCI-Geräts. Dieser Bezeichner oder Alias wird zugewiesen, wenn das Gerät geöffnet wird.

lpszPalette

Eines der folgenden Flags.

Wert Bedeutung
background Realisiert die Palette als Hintergrundpalette.
normal Realisiert die Palette für ein Fenster der obersten Ebene. Dies ist die Standardeinstellung.

lpszFlags

Kann "wait", "notify" oder beides sein. Für Digitalvideogeräte kann auch "test" angegeben werden. Weitere Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.

Rückgabewert

Gibt 0 (null) zurück, wenn erfolgreich, andernfalls ein Fehler.

Bemerkungen

Verwenden Sie diesen Befehl nur, wenn Ihre Anwendung ein Fensterhandle verwendet und eine WM _ QUERYNEWPALTONE- oder WM _ PALETTECHANGED-Meldung empfängt.

Beispiele

Der folgende Befehl weist das Gerät "myvideo" an, seine Palette zu realisieren.

realize myvideo normal

Requirements (Anforderungen)

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

Weitere Informationen

MCI

MCI-Befehlszeichenfolgen