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

[アーティクル]
08/24/2023

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

構文

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_DF2RAW_MEDIA_IS_NOT_SUPPORTED	空の CD-R/RW メディアのみがサポートされています。値: 0xC0AA0606
E_IMAPI_DF2RAW_MEDIA_IS_NOT_BLANK	空の CD-R/RW メディアのみがサポートされています。値: 0xC0AA0607
E_IMAPI_DF2RAW_CLIENT_NAME_IS_NOT_VALID	クライアント名が無効です。値: 0xC0AA0604
S_IMAPI_ROTATIONADJUSTED	要求された回転の種類がドライブでサポートされておらず、回転の種類が調整されました。値: 0x00AA0005
S_IMAPI_SPEEDADJUSTED	要求された書き込み速度はドライブでサポートされておらず、速度が調整されました。値: 0x00AA0004
S_IMAPI_BOTHADJUSTED	要求された書き込み速度と回転の種類は、ドライブでサポートされておらず、両方とも調整されました。値: 0x00AA0006

解説

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

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

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

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

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

要件


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

次の方法で共有

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

構文

パラメーター

戻り値

解説

要件

関連項目

フィードバック

その他のリソース