IDiscRecorder2Ex::GetFeaturePage メソッド (imapi2.h)
指定した機能ページをデバイスから取得します。
構文
HRESULT GetFeaturePage(
[in] IMAPI_FEATURE_PAGE_TYPE requestedFeature,
[in] BOOLEAN currentFeatureOnly,
[out] BYTE **featureData,
[out] ULONG_IMAPI2_FEATURE_PAGE *byteSize
);
パラメーター
[in] requestedFeature
取得する機能ページ。 使用可能な値については、IMAPI_FEATURE_PAGE_TYPE列挙型に関 する ページを参照してください。
[in] currentFeatureOnly
現在の機能ページの場合にのみ機能ページを取得するには、True に設定します。 それ以外の場合、現在の機能ページに関係なく機能ページを取得する場合は False。
[out] featureData
機能ページを含むデータ バッファー。 データ バッファーの内容の詳細については、MMC 仕様の最新リビジョンの GET CONFIGURATION コマンド ( ftp://ftp.t10.org/t10/drafts/mmc5) を参照してください。
このメソッドは、このバッファーを入力して送信する前に、ヘッダー情報やその他の機能以外のデータを削除します。
完了したら、 CoTaskMemFree 関数を呼び出してメモリを解放します。
[out] byteSize
featureData データ バッファーのサイズ (バイト単位)。
戻り値
S_OKは成功時に返されますが、実装の結果として他の成功コードが返される場合があります。 次のエラー コードは通常、操作の失敗時に返されますが、考えられる唯一のエラー値を表すわけではありません。
| リターン コード | 説明 |
|---|---|
|
ポインターが無効です。
値: 0x80004003 |
|
不特定のエラー。
値: 0x80004005 |
|
ドライブは GET CONFIGURATION コマンドをサポートしていません。
値: 0xC0AA020C |
|
要求された機能ページは、デバイスではサポートされていません。
値: 0xC0AA020A |
|
必要なメモリを割り当てませんでした。
値: 0x8007000E |
|
要求された機能ページはサポートされていますが、現在の機能としてマークされていません。
値: 0xC0AA020B |
|
デバイスは、タイムアウト期間内にコマンドを受け入れませんでした。 これは、デバイスが不整合な状態になったか、コマンドのタイムアウト値を増やす必要がある場合があります。
値: 0xC0AA020D |
|
デバイスから、コマンドの予期しないデータまたは無効なデータが報告されました。
値: 0xC0AA02FF |
|
メディアは上下逆さまで挿入されます。
値: 0xC0AA0204 |
|
ドライブは、準備が整っていることを報告しました。 後でもう一度要求を試してください。
値: 0xC0AA0205 |
|
デバイスにメディアがありません。
値: 0xC0AA0202 |
|
メディアは現在書式設定されています。 メディアを使用する前に、形式が完了するまで待ってください。
値: 0xC0AA0206 |
|
ドライブは、書き込みの完了など、実行時間の長い操作を実行していることを報告しました。 ドライブが長期間使用できない場合があります。
値: 0xC0AA0207 |
|
ドライブが書き込みを続行するのに十分な速さでデータを受信できなかったため、書き込みに失敗しました。 ソース データをローカル コンピューターに移動したり、書き込み速度を低下させたり、"バッファー アンダーランフリー" 設定を有効にしたりすると、この問題が解決する可能性があります。
値: 0xC0AA0300 |
|
メディアに互換性がない、または物理形式が不明です。
値: 0xC0AA0203 |
|
DVD 構造が存在しません。 これは、互換性のないドライブ/メディアが使用されている場合に発生する可能性があります。
値: 0xC0AA020E |
|
デバイスは、要求されたモード ページ (および種類) が存在しないことを報告しました。
値: 0xC0AA0201 |
|
ドライブは、MODE SELECT コマンドのモード ページで指定されたパラメーターの組み合わせがサポートされていないことを報告しました。
値: 0xC0AA0208 |
|
ドライブから、メディアが書き込みが保護されていることが報告されました。
値: 0xC0AA0209 |
|
メディアの速度はデバイスと互換性がありません。 これは、デバイスでサポートされている速度の範囲よりも高いまたは低い速度メディアを使用することによって発生する可能性があります。
値: 0xC0AA020F |
|
指定されたハンドルが無効です。
値: 6 |
|
指定したネットワーク リソースまたはデバイスが使用できなくなりました。
値: 55 |
|
最後の操作中にこのレコーダーに関連付けられているデバイスが排他的にロックされているため、この操作は失敗します。
値: 0xC0AA0210 |
要件
| サポートされている最小のクライアント | Windows Vista、WINDOWS XP と SP2 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | imapi2.h |