comando MCI_RESERVE

Il comando MCI_RESERVE alloca spazio su disco contiguo per l'area di lavoro dell'istanza del driver di dispositivo da usare con la registrazione successiva. I dispositivi digital-video riconoscono questo comando.

Per inviare questo comando, chiamare la funzione mciSendCommand con i parametri seguenti.

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

Parametri

wDeviceID

Identificatore del dispositivo MCI che deve ricevere il messaggio di comando.

Dwflags

MCI_NOTIFY, MCI_WAIT o MCI_TEST. Per informazioni su questi flag, vedere Il flag Wait, Notify e Test Flag.

lpReserve

Puntatore a una struttura MCI_DGV_RESERVE_PARMS .

Valore restituito

Restituisce zero se ha esito positivo o un errore in caso contrario.

Commenti

Se l'area di lavoro contiene dati non salvati, questi dati vengono persi. Se lo spazio su disco non è riservato prima della registrazione, il comando MCI_RECORD esegue una riserva implicita con parametri predefiniti specifici del dispositivo. In alcune implementazioni, la riserva non è necessaria e potrebbe essere ignorata dal driver del dispositivo. Lo spazio riservato in modo esplicito consente di controllare meglio quando si verifica il ritardo per l'allocazione del disco, la quantità di spazio allocata e la posizione in cui viene allocato lo spazio su disco. La quantità e la posizione dello spazio su disco già riservata per questa istanza del dispositivo possono essere modificate eseguendo di nuovo MCI_RESERVE. Qualsiasi spazio su disco allocato e ancora inutilizzato non viene deallocato fino a quando non vengono salvati dati registrati o finché l'istanza del driver del dispositivo non viene chiusa.

Se il video viene disattivato con il flag MCI_OFF del comando MCI_SETVIDEO , lo spazio riservato non include alcun video. Se l'audio viene disattivato con il flag MCI_OFF del comando MCI_SETAUDIO , lo spazio riservato non include alcun audio. Se sia audio che video vengono disattivati o se la dimensione richiesta è zero, non viene riservato spazio e qualsiasi spazio riservato esistente viene deallocato.

I flag aggiuntivi seguenti si applicano ai dispositivi digital-video:

MCI_DGV_RESERVE_IN

Il membro lpstrPath della struttura identificata da lpReserve contiene un indirizzo di un buffer contenente il percorso di un file temporaneo. Il buffer contiene solo il percorso dell'unità e della directory del file usato per contenere dati registrati; il nome del file viene specificato dal driver del dispositivo. Questo file temporaneo viene eliminato quando l'istanza del dispositivo viene chiusa a meno che non venga salvata in modo esplicito. Se questo flag viene omesso, il driver del dispositivo specifica dove viene allocato spazio su disco.

MCI_DGV_RESERVE_SIZE

Il membro dwSize della struttura identificata da lpReserve specifica la quantità approssimativa di spazio su disco da riservare nell'area di lavoro per la registrazione. Il valore viene specificato nel formato ora corrente. La quantità di spazio su disco viene stimata dal tempo richiesto e dal quale vengono applicati valori di formato file e video e audio e qualità. Se questo flag viene omesso, il driver del dispositivo potrebbe usare un valore predefinito che definisce.

Requisiti

Requisito Valore
Client minimo supportato
Windows 2000 Professional [solo app desktop]
Server minimo supportato
Windows 2000 Server [solo app desktop]
Intestazione
Mmsystem.h (include Windows.h)

Vedi anche

MCI

Comandi MCI