Befehl "reserve"

Der Befehl reserve weist dem Arbeitsbereich des Geräts instance zusammenhängenden Speicherplatz zu. Digital-Videogerä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("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
im Pfad	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 nicht angegeben wird, gibt das Gerät den Speicherort des Speicherplatzes an.
Größendauer	Gibt die ungefähre Menge an Speicherplatz an, der im Arbeitsbereich reserviert werden soll. Der Wert für die Dauer wird im aktuellen Zeitformat angegeben. Das Gerät basiert auf der Schätzung des erforderlichen Speicherplatzes auf den folgenden Parametern: der angeforderten Zeit, dem Dateiformat, dem Video- und Audiokomprimierungsalgorithmus und den tatsächlichen Komprimierungsqualitätswerten. Wenn setvideo "record" "off" ist, ist der Speicherplatz nur für Audio reserviert. Wenn setaudio "record" "off" ist, ist Speicherplatz nur für Video reserviert. Wenn beide "off" sind oder die Dauer 0 ist, wird kein Speicherplatz reserviert, und jeder vorhandene reservierte Speicherplatz wird zugeordnet. Wenn dieses Flag nicht angegeben wird, verwendet das Gerät einen gerätedefinierten Standardwert.

lpszFlags

Kann "warten", "benachrichtigen", "testen" oder eine Kombination aus diesen sein. 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

Bei Bedarf verwenden nachfolgende Aufzeichnungs - oder Speicherbefehle den durch diesen Befehl reservierten Speicherplatz. Wenn der Arbeitsbereich nicht gespeicherte Daten enthält, gehen die Daten verloren. Einige Geräte erfordern keine Reservierung und ignorieren sie. Wenn vor der Aufzeichnung kein Speicherplatz reserviert ist, 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 Verzögerung für die Datenträgerzuordnung auftritt, wie viel Speicherplatz zugewiesen wird und wo der Speicherplatz zugewiesen wird. Ihre Anwendung kann die Menge und den Speicherort des zuvor reservierten Speicherplatzes mit nachfolgenden Reservebefehlen ändern. Der zugewiesene und noch nicht verwendete Speicherplatz wird erst dann aufgehoben, wenn aufgezeichnete Daten gespeichert werden oder bis das Gerät instance geschlossen wird.

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

record

Speichern

Setaudio

setvideo