Reserve-Befehl
Mit dem Befehl reserve wird zusammenhängender Speicherplatz für den Arbeitsbereich der Geräteinstanz reserviert. 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("reserve %s %s %s"),
lpszDeviceID,
lpszReserve,
lpszFlags
);
Parameter
-
lpszDeviceID
-
Bezeichner eines MCI-Geräts. Dieser Bezeichner oder Alias wird zugewiesen, wenn das Gerät geöffnet wird.
-
lpszReserve
-
Mindestens eines der folgenden Flags.
Wert Bedeutung in path Gibt den Laufwerks- und Verzeichnispfad (aber nicht den Namen) einer temporären Datei an, die zum Speichern aufgezeichneter Daten verwendet wird. Der Name dieser Datei wird vom Gerät angegeben. Die temporäre Datei wird gelöscht, wenn das Gerät geschlossen wird. Wenn dieses Flag weggelassen wird, gibt das Gerät den Speicherort des Speicherplatzes an. Dauer der Größe Gibt die ungefähre Menge an Speicherplatz an, die im Arbeitsbereich reservieren werden soll. Der Duration-Wert wird im aktuellen Zeitformat angegeben. Das Gerät basiert seine Schätzung des erforderlichen Speicherplatzes auf den folgenden Parametern: der angeforderten Zeit, dem Dateiformat, dem Video- und Audiokomprimierungsalgorithmus und den tatsächlichen Werten für die Komprimierungsqualität. Wenn setvideo "record" auf "off" festgelegt ist, wird Speicherplatz nur für Audiodaten reserviert. Wenn setaudio "record" auf "off" festgelegt ist, wird Speicherplatz nur für Videos reserviert. Wenn beide "off" sind oder die Dauer 0 (null) beträgt, wird kein Speicherplatz reserviert, und der vorhandene reservierte Speicherplatz wird wieder frei. Wenn dieses Flag weggelassen wird, verwendet das Gerät einen gerätedefinierten Standardwert. -
lpszFlags
-
Kann "wait", "notify", "test" oder eine Kombination aus diesen sein. 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
Bei Bedarf verwenden nachfolgende Aufzeichnungs- oder Speicherbefehle den von diesem Befehl reservierten Speicherplatz. Wenn der Arbeitsbereich nicht gespeicherte Daten enthält, gehen die Daten verloren. Einige Geräte erfordern keine Reserve und ignorieren sie. Wenn vor der Aufzeichnung kein Speicherplatz reserviert wird, führt der Datensatzbefehl eine implizite Reserve mit gerätespezifischen Standardflags aus. Verwenden Sie einen expliziten Reservebefehl, wenn Sie besser steuern möchten, wann die Datenträgerzuordnung verzögert wird, steuern Sie, wie viel Speicherplatz zugeordnet wird, und steuern Sie, wo der Speicherplatz zugeordnet wird. Ihre Anwendung kann die Menge und den Speicherort des zuvor reservierten Speicherplatzes mit nachfolgenden Reservebefehlen ändern. Der zugeordnete und noch nicht genutzte Speicherplatz wird erst wieder verfügbar gemacht, wenn aufgezeichnete Daten gespeichert oder die Geräteinstanz geschlossen wird.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |