MCI _ LOAD-Befehl

Der MCI _ LOAD-Befehl lädt eine Datei. Digital-Video- 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_LOAD, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_LOAD_PARMS) lpLoad
);

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 Die Warte-, Benachrichtigungs- und Testflags.

lpLoad

Zeiger auf eine MCI _ LOAD _ PARMS-Struktur. (Geräte mit zusätzlichen Parametern ersetzen diese Struktur möglicherweise durch eine gerätespezifische Struktur. Bei Digitalvideogeräten verweist der lpLoad-Parameter auf eine MCI _ DGV _ LOAD _ PARMS-Struktur.)

Rückgabewert

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

Bemerkungen

Das folgende zusätzliche Flag gilt für alle Geräte, die MCI _ LOAD unterstützen:

MCI _ LOAD _ FILE

Der lpfilename-Member der durch lpLoad identifizierten Struktur enthält eine Adresse eines Puffers, der den Dateinamen enthält.

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

MCI _ OVLY _ RECT

Der rc-Member der durch lpLoad identifizierten Struktur enthält ein gültiges Anzeigerechteck, das den Bereich des zu aktualisierenden Videopuffers identifiziert.

Bei Videoüberlagerungsgeräten verweist der lpLoad-Parameter auf eine MCI _ OVLY _ LOAD _ 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 (include Windows.h)

Siehe auch

MCI

MCI-Befehle