次の方法で共有


IDiscFormat2Data::SetWriteSpeed メソッド (imapi2.h)

ディスク レコーダーの書き込み速度を設定します。

構文

HRESULT SetWriteSpeed(
  [in] LONG         RequestedSectorsPerSecond,
  [in] VARIANT_BOOL RotationTypeIsPureCAV
);

パラメーター

[in] RequestedSectorsPerSecond

1 秒あたりのディスク セクターで測定された書き込み速度を要求しました。

メディアでサポートされている最速の速度を使用して書き込みが行われる0xFFFFFFFF (-1) 要求の値。 既定値です。

[in] RotationTypeIsPureCAV

要求された回転速度制御タイプ。 一定角速度 (CAV) の回転速度制御タイプを要求するには、VARIANT_TRUE に設定します。 レコーダーがサポートする別の回転速度制御タイプを使用するには、VARIANT_FALSE に設定します。 既定値は VARIANT_FALSE です。

戻り値

S_OKは成功時に返されますが、実装の結果として他の成功コードが返される場合があります。 次のエラー コードは、通常、操作の失敗時に返されますが、考えられる唯一のエラー値を表すわけではありません。

リターン コード 説明
E_IMAPI_RECORDER_REQUIRED
この要求では、現在のディスク レコーダーを選択する必要があります。

値: 0xC0AA0003

E_INVALIDARG
1 つ以上の引数が無効です。

値: 0x80070057

E_POINTER
ポインターが無効です。

値: 0x80004003

E_FAIL
不特定のエラー。

値: 0x80004005

E_OUTOFMEMORY
必要なメモリを割り当てませんでした。

値: 0x8007000E

E_IMAPI_RECORDER_COMMAND_TIMEOUT
デバイスは、タイムアウト期間内にコマンドを受け入れませんでした。 これは、デバイスが不整合な状態になったか、コマンドのタイムアウト値を増やす必要がある場合があります。

値: 0xC0AA020D

E_IMAPI_RECORDER_INVALID_RESPONSE_FROM_DEVICE
デバイスは、コマンドの予期しないデータまたは無効なデータを報告しました。

値: 0xC0AA02FF

E_IMAPI_RECORDER_MEDIA_UPSIDE_DOWN
メディアは上下逆に挿入されます。

値: 0xC0AA0204

E_IMAPI_RECORDER_MEDIA_BECOMING_READY
ドライブから、準備中であることが報告されました。 後でもう一度要求を試してください。

値: 0xC0AA0205

E_IMAPI_RECORDER_MEDIA_NO_MEDIA
デバイスにメディアがありません。

値: 0xC0AA0202

E_IMAPI_RECORDER_MEDIA_FORMAT_IN_PROGRESS
メディアは現在書式設定されています。 メディアの使用を試みる前に、フォーマットが完了するまで待ってください。

値: 0xC0AA0206

E_IMAPI_RECORDER_MEDIA_BUSY
ドライブから、書き込みの完了など、実行時間の長い操作が実行されていることが報告されました。 ドライブが長期間使用できない場合があります。

値: 0xC0AA0207

E_IMAPI_LOSS_OF_STREAMING
ドライブが書き込みを続行するのに十分な速さでデータを受信できなかったため、書き込みに失敗しました。 ソース データをローカル コンピューターに移動したり、書き込み速度を低下させたり、"バッファー アンダーラン フリー" 設定を有効にしたりすると、この問題が解決する可能性があります。

値: 0xC0AA0300

E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE
メディアに互換性がない、または物理形式が不明です。

値: 0xC0AA0203

E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT
DVD 構造が存在しません。 これは、互換性のないドライブ/メディアが使用されている場合に発生する可能性があります。

値: 0xC0AA020E

E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE
デバイスから、要求されたモード ページ (および種類) が存在しないことが報告されました。

値: 0xC0AA0201

E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS
ドライブは、MODE SELECT コマンドのモード ページで指定されたパラメーターの組み合わせがサポートされていないことを報告しました。

値: 0xC0AA0208

E_IMAPI_RECORDER_MEDIA_WRITE_PROTECTED
ドライブは、メディアが書き込み保護されていることを報告しました。

値: 0xC0AA0209

E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH
メディアの速度はデバイスと互換性がありません。 これは、デバイスでサポートされている速度の範囲よりも高いまたは低い速度メディアを使用することによって発生する可能性があります。

値: 0xC0AA020F

HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE)
指定されたハンドルが無効です。

値: 6

HRESULT_FROM_WIN32(ERROR_DEV_NOT_EXIST)
指定したネットワーク リソースまたはデバイスが使用できなくなりました。

値: 55

E_IMAPI_RECORDER_LOCKED
前回の操作中にこのレコーダーに関連付けられているデバイスが排他的にロックされているため、この操作は失敗しました。

値: 0xC0AA0210

E_IMAPI_UNEXPECTED_RESPONSE_FROM_DEVICE
ドライブから回復できないエラー情報が返されたため、書き込みに失敗しました。

値: 0xC0AA0301

S_IMAPI_ROTATIONADJUSTED
要求された回転の種類がドライブでサポートされておらず、回転の種類が調整されました。

値: 0x00AA0005

S_IMAPI_SPEEDADJUSTED
要求された書き込み速度はドライブでサポートされておらず、速度が調整されました。

値: 0x00AA0004

S_IMAPI_BOTHADJUSTED
要求された書き込み速度と回転の種類は、ドライブでサポートされておらず、両方とも調整されました。

値: 0x00AA0006

解説

このメソッドは、レコーダーの書き込み速度と回転速度制御の種類を設定します。 要求された値は、レコーダーで設定された値とは異なる場合があります。 レコーダーを指定するには、 IDiscFormat2Data::p ut_Recorder メソッドを 呼び出します。

レコーダーが要求された書き込み速度をサポートしている場合、ディスク デバイスは要求された値を使用します。 レコーダーが要求された書き込み速度をサポートしていない場合、レコーダーは、要求された値に最も近い書き込み速度を使用します。 IDiscFormat2Data::get_CurrentWriteSpeed プロパティには、レコーダーで使用される値が含まれています。

レコーダーと現在のメディアがサポートする書き込み速度の一覧を取得するには、 IDiscFormat2Data::get_SupportedWriteSpeeds メソッドを呼び出します。

回転速度制御タイプに対して一定の角速度(CAV)を要求し、レコーダーがCAVをサポートしていない場合、ディスクデバイスは、それがサポートする別のタイプの回転数制御タイプを使用します。 IDiscFormat2Data::get_CurrentRotationTypeIsPureCAV プロパティは、レコーダーで使用される値を示します。

要求された値を取得するには、 IDiscFormat2Data::get_RequestedWriteSpeed メソッドと IDiscFormat2Data::get_RequestedRotationTypeIsPureCAV メソッドを 呼び出します。

要件

   
サポートされている最小のクライアント Windows Vista、WINDOWS XP と SP2 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー imapi2.h

関連項目

IDiscFormat2Data

IDiscFormat2Data::get_CurrentRotationTypeIsPureCAV

IDiscFormat2Data::get_RequestedRotationTypeIsPureCAV

IDiscFormat2Data::get_SupportedWriteSpeedDescriptors

IDiscFormat2Data::get_SupportedWriteSpeeds