MCI _ RESERVE-Befehl

Der MCI _ RESERVE-Befehl ordnet dem Arbeitsbereich der Gerätetreiberinstanz zusammenhängenden Speicherplatz für die Verwendung mit nachfolgender Aufzeichnung zu. Digitalvideogeräte erkennen diesen Befehl.

Rufen Sie zum Senden dieses Befehls die mciSendCommand-Funktion mit den folgenden Parametern auf.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_RESERVE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_DGV_RESERVE_PARMS) lpReserve
);

Parameter

wDeviceID

Gerätebezeichner des MCI-Geräts, das die Befehlsmeldung empfangen soll.

Dwflags

MCI _ NOTIFY, MCI _ WAIT oder MCI _ TEST. Informationen zu diesen Flags finden Sie unter Die Warte-, Benachrichtigungs- und Testflags.

lpReserve

Zeiger auf eine MCI _ DGV _ RESERVE _ PARMS-Struktur.

Rückgabewert

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

Bemerkungen

Wenn der Arbeitsbereich nicht gespeicherte Daten enthält, geht er verloren. Wenn vor der Aufzeichnung kein Speicherplatz reserviert wird, führt der MCI _ RECORD-Befehl eine implizite Reserve mit gerätespezifischen Standardparametern aus. Bei einigen Implementierungen ist die Reservierung nicht erforderlich und wird möglicherweise vom Gerätetreiber ignoriert. Durch das explizite Reservieren von Speicherplatz können Sie besser steuern, wann die Verzögerung für die Datenträgerzuordnung auftritt, wie viel Speicherplatz belegt wird und wo der Speicherplatz zugeordnet wird. Menge und Speicherort des bereits für diese Geräteinstanz reservierten Speicherplatzes können durch erneute Ausgabe von MCI RESERVE geändert _ werden. Der zugeordnete und noch nicht belegte Speicherplatz wird erst freigegeben, wenn aufgezeichnete Daten gespeichert oder die Gerätetreiberinstanz geschlossen wurde.

Wenn video mit dem MCI _ OFF-Flag des MCI _ SETVIDEO-Befehls deaktiviert wird, enthält der reservierte Speicherplatz kein Video. Wenn audio mit dem MCI _ OFF-Flag des MCI _ SETAUDIO-Befehls deaktiviert wird, enthält der reservierte Speicherplatz keine Audiodaten. Wenn sowohl Audio als auch Video deaktiviert sind oder die angeforderte Größe 0 (null) ist, wird kein Speicherplatz reserviert, und die Zuordnung des vorhandenen reservierten Speicherplatzes wird freigegeben.

Die folgenden zusätzlichen Flags gelten für Digitalvideogeräte:

MCI _ DGV _ RESERVE _ IN

Der lpstrPath-Member der von lpReserve identifizierten Struktur enthält eine Adresse eines Puffers, der den Speicherort einer temporären Datei enthält. Der Puffer enthält nur das Laufwerk und den Verzeichnispfad der Datei, die zum Speichern aufgezeichneter Daten verwendet wird. Der Dateiname wird vom Gerätetreiber angegeben. Diese temporäre Datei wird gelöscht, wenn die Geräteinstanz geschlossen wird, es sei denn, sie wird explizit gespeichert. Wenn dieses Flag ausgelassen wird, gibt der Gerätetreiber an, wo Speicherplatz zugewiesen wird.

MCI _ DGV _ RESERVE _ SIZE

Der dwSize-Member der von lpReserve identifizierten Struktur gibt den ungefähren Speicherplatz an, der im Arbeitsbereich für die Aufzeichnung reserviert werden soll. Der Wert wird im aktuellen Zeitformat angegeben. Der Speicherplatz auf dem Datenträger wird ab dem angeforderten Zeitpunkt geschätzt, ab dem Dateiformat, Video- und Audioalgorithmus sowie Qualitätswerte wirksam sind. Wenn dieses Flag ausgelassen wird, verwendet der Gerätetreiber möglicherweise einen von ihm definierten Standardwert.

Requirements (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)

Weitere Informationen

MCI

MCI-Befehle