MCI_RESERVE コマンド

MCI_RESERVE コマンドは、後続の記録で使用するために、デバイス ドライバー インスタンスのワークスペースに連続するディスク領域を割り当てます。 デジタル ビデオ デバイスはこのコマンドを認識します。

このコマンドを送信するには、次のパラメーターを指定して mciSendCommand 関数を呼び出します。

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

パラメーター

wDeviceID

コマンド メッセージを受信する MCI デバイスのデバイス識別子。

dwFlags

MCI_NOTIFY、MCI_WAIT、またはMCI_TEST。 これらのフラグの詳細については、「 待機、通知、およびテスト フラグ」を参照してください。

lpReserve

MCI_DGV_RESERVE_PARMS構造体へのポインター。

戻り値

成功した場合は 0 を返し、それ以外の場合はエラーを返します。

解説

ワークスペースに未保存のデータが含まれている場合、このデータは失われます。 記録の前にディスク領域が予約されていない場合、 MCI_RECORD コマンドは、デバイス固有の既定のパラメーターを使用して暗黙的な予約を実行します。 一部の実装では、予約は必須ではなく、デバイス ドライバーによって無視される場合があります。 領域を明示的に予約すると、ディスク割り当ての遅延が発生するタイミング、割り当てられる領域の量、ディスク領域の割り当て場所をより適切に制御できます。 このデバイス インスタンス用に既に予約されているディスク領域の量と場所は、MCI_RESERVEを再度発行することで変更できます。 割り当てられた未使用のディスク領域は、記録されたデータが保存されるまで、またはデバイス ドライバー インスタンスが閉じられるまで割り当て解除されません。

MCI_SETVIDEO コマンドの MCI_OFF フラグを使用してビデオをオフにした場合、予約されている領域にはビデオは含まれません。 MCI_SETAUDIO コマンドの MCI_OFF フラグを使用してオーディオをオフにした場合、予約されている領域にオーディオは含まれません。 オーディオとビデオの両方がオフになっている場合、または要求されたサイズが 0 の場合、スペースは予約されておらず、既存の予約済み領域は割り当て解除されます。

デジタル ビデオ デバイスには、次の追加フラグが適用されます。

MCI_DGV_RESERVE_IN

lpReserve によって識別される構造体の lpstrPath メンバーには、一時ファイルの場所を含むバッファーのアドレスが含まれています。 バッファーには、記録されたデータを保持するために使用されるファイルのドライブとディレクトリ パスのみが含まれます。ファイル名は、デバイス ドライバーによって指定されます。 この一時ファイルは、明示的に保存されていない限り、デバイス インスタンスが閉じられると削除されます。 このフラグを省略すると、デバイス ドライバーはディスク領域を割り当てる場所を指定します。

MCI_DGV_RESERVE_SIZE

lpReserve によって識別される構造体の dwSize メンバーは、記録のためにワークスペースに予約するディスク領域の概算量を指定します。 値は現在の時刻形式で指定されます。 ディスク領域の量は、要求された時間から推定され、そこからファイル形式とビデオとオーディオのアルゴリズムと品質の値が有効になります。 このフラグを省略すると、デバイス ドライバーで定義されている既定値が使用される場合があります。

必要条件

関連項目

Mci

MCI コマンド