Befehl "realize"

Der Befehl zum Realisieren weist ein Gerät an, seine Palette im Anzeigekontext des angezeigten Fensters auszuwählen und zu realisieren. Digital-Video-Geräte erkennen diesen Befehl.

Um diesen Befehl zu senden, rufen Sie die mciSendString-Funktion auf, wobei der parameter lpszCommand 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 auf oberster Ebene. Dies ist die Standardeinstellung.

lpszFlags

Kann "warte", "benachrichtigen" oder beides sein. Für Digital-Video-Geräte kann auch "Test" angegeben werden. Weitere Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.

Rückgabewert

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

Bemerkungen

Verwenden Sie diesen Befehl nur, wenn Ihre Anwendung ein Fensterhandle verwendet und eine WM_QUERYNEWPALLETTE - oder WM_PALETTECHANGED-Nachricht empfängt.

Beispiele

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

realize myvideo normal

Anforderungen

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

Siehe auch

MCI

MCI-Befehlszeichenfolgen