befehl "MCI_RESERVE"

Der Befehl MCI_RESERVE reserviert zusammenhängenden Speicherplatz für den Arbeitsbereich des Gerätetreibers instance zur Verwendung bei der nachfolgenden Aufzeichnung. Digital-Video-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_RESERVE, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_DGV_RESERVE_PARMS) lpReserve
);

Parameter

wDeviceID

Geräte-ID des MCI-Geräts, das die Befehlsnachricht 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 null zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt.

Bemerkungen

Wenn der Arbeitsbereich nicht gespeicherte Daten enthält, gehen diese Daten verloren. Wenn vor der Aufzeichnung kein Speicherplatz reserviert ist, führt der befehl MCI_RECORD 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 die explizite Reservierung von Speicherplatz können Sie besser steuern, wann die Verzögerung für die Datenträgerzuweisung auftritt, wie viel Speicherplatz belegt wird und wo der Speicherplatz zugewiesen wird. Die Menge und der Speicherort des bereits für dieses Gerät reservierten Speicherplatzes instance können durch erneutes Ausgeben von MCI_RESERVE geändert werden. Der zugeordnete und noch nicht verwendete Speicherplatz wird erst aufgehoben, wenn aufgezeichnete Daten gespeichert werden oder bis der Gerätetreiber instance geschlossen wird.

Wenn das Video mit dem MCI_OFF-Flag des Befehls MCI_SETVIDEO deaktiviert wird, enthält der reservierte Speicherplatz kein Video. Wenn audio mit dem MCI_OFF-Flag des Befehls MCI_SETAUDIO deaktiviert wird, enthält der reservierte Speicherplatz keine Audiodaten. Wenn Audio und Video deaktiviert sind oder die angeforderte Größe null ist, wird kein Speicherplatz reserviert, und die Zuordnung des vorhandenen reservierten Speicherplatzes wird aufgehoben.

Die folgenden zusätzlichen Flags gelten für Digital-Video-Gerä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 den Laufwerks- und 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 das Gerät instance geschlossen wird, es sei denn, es wird explizit gespeichert. Wenn dieses Flag weggelassen 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. Die Menge des Speicherplatzes wird ab der angeforderten Zeit geschätzt, ab der Dateiformate, Video- und Audioalgorithmus und Qualitätswerte wirksam sind. Wenn dieses Flag weggelassen wird, verwendet der Gerätetreiber möglicherweise einen von diesem definierten Standardwert.

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 (windows.h einschließen)

Siehe auch

MCI

MCI-Befehle