load-Befehl

Der Befehl zum Laden lädt eine Datei in einem gerätespezifischen Format. Digital-Video- und Video-Overlay-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("load %s %s %s"), 
  lpszDeviceID, 
  lpszFilePos, 
  lpszFlags
); 

Parameter

lpszDeviceID

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

lpszFilePos

Pfad und Dateiname zum Laden. Bei Videoüberlagerungsgeräten kann dies auch ein Zielrechteck für die Daten enthalten. Um ein Zielrechteck anzugeben, geben Sie "at" gefolgt von X1 Y1 X2 Y2 an, wobei X1 Y1 die obere linke Ecke des Rechtecks und X2 Y2 die Breite und Höhe angeben. Das Rechteck ist relativ zum Ursprung des Videopuffers.

lpszFlags

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

Rückgabewert

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

Bemerkungen

Das "vidboard"-Gerät sendet eine Benachrichtigung, wenn das Laden abgeschlossen ist.

Beispiele

Der folgende Befehl lädt eine Datei in das "vidboard"-Gerät.

load vidboard c:\vid\fish.vid notify

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