befehl MCI_LOAD

Der befehl MCI_LOAD lädt eine Datei. Digital-Video- und Video-Overlay-Gerä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 Warte-, Benachrichtigungs- und Testflags.

lpLoad

Zeiger auf eine MCI_LOAD_PARMS-Struktur . (Geräte mit zusätzlichen Parametern können diese Struktur durch eine gerätespezifische Struktur ersetzen. Bei Digitalvideogeräten verweist der lpLoad-Parameter auf eine MCI_DGV_LOAD_PARMS Struktur.)

Rückgabewert

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

Bemerkungen

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

MCI_LOAD_FILE

Das lpfilename-Element 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

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

Weitere Informationen

MCI

MCI-Befehle