IMAPI2管理. [詳解]

#include <TnbImageMastering.h>

CImageMastering の継承関係図

クラス
class	CDiscImage
	ディスクイメージ管理. [詳解]

class	CDrive
	ドライブ管理. [詳解]

公開型
typedef CPointerHandleBaseT< IDiscFormat2Data , TImReleasePointerT< IDiscFormat2Data > >	CDiscFormatDataHandle
	DiscFormatData ハンドル [詳解]

typedef CPointerHandleBaseT< IDiscFormat2Erase , TImReleasePointerT< IDiscFormat2Erase > >	CDiscFormatEraseHandle
	DiscFormatErase ハンドル [詳解]

typedef CPointerHandleBaseT< IDiscMaster2 , TImReleasePointerT< IDiscMaster2 > >	CDiscMasterHandle
	DiscMaster ハンドル [詳解]

typedef CPointerHandleBaseT< IDiscRecorder2 , TImReleasePointerT< IDiscRecorder2 > >	CDiscRecorderHandle
	DiscRecorder ハンドル [詳解]

typedef CPointerHandleBaseT< IFileSystemImage , TImReleasePointerT< IFileSystemImage > >	CFileSystemImageHandle
	FileSystemImage ハンドル [詳解]

公開メンバ関数
	CImageMastering (void)
	コンストラクタ [詳解]

CDrive	CreateDrive (INDEX index) const
	[取得] ドライブ管理クラス取得. [詳解]

size_t	GetDriveCount (void) const
	[取得] ドライブ数取得. [詳解]

CStr	GetDriveName (INDEX index) const
	[取得] ドライブ名取得. [詳解]

HRESULT	GetLastResult (void) const
	[取得] リザルトコード取得. [詳解]

CStr	GetLastResultString (void) const
	[取得] リザルト文字列取得. [詳解]

bool	IsSupported (void) const
	[確認] サポート確認. [詳解]

静的公開メンバ関数
static HRESULT	CreateStreamOnFile (LPCTSTR lpszFile, DWORD grfMode, IStream **ppstm)
	[作成] ファイルストリーム作成. [詳解]

static CStr	ToString (HRESULT hr)
	[変換] リザルト文字列変換. [詳解]

static CStr	ToString (IMAPI_MEDIA_PHYSICAL_TYPE type)
	[取得] ディスク種類文字取得. [詳解]

限定公開メンバ関数
bool	CheckRes (HRESULT hr) const
	[設定] リザルトチェック. [詳解]

詳解

IMAPI2管理.

覚え書き

デフォルトの XP に IMAPI2 は含まれていません。以下のサーバからダウンロードしてインストールする必要があります。

(必須) Windows XP 用 Image Mastering API v2.0 (IMAPIv2.0)
http://www.microsoft.com/downloads/details.aspx?familyid=B5F726F1-4ACE-455D-BAD7-ABC4DD2F147B&displaylang=ja
(任意) Windows Feature Pack 1.0
http://www.microsoft.com/downloads/details.aspx?FamilyID=63ab51ea-99c9-45c0-980a-c556746fcf05&DisplayLang=ja

必要ファイル: TnbImageMastering.h

日付: 09/08/08 新規作成

TnbImageMastering.h の 452 行目に定義があります。

型定義メンバ詳解

◆ CDiscFormatDataHandle

typedef CPointerHandleBaseT<IDiscFormat2Data*, TImReleasePointerT<IDiscFormat2Data*> > CDiscFormatDataHandle

DiscFormatData ハンドル

TnbImageMastering.h の 466 行目に定義があります。

◆ CDiscFormatEraseHandle

typedef CPointerHandleBaseT<IDiscFormat2Erase*, TImReleasePointerT<IDiscFormat2Erase*> > CDiscFormatEraseHandle

DiscFormatErase ハンドル

TnbImageMastering.h の 469 行目に定義があります。

◆ CDiscMasterHandle

typedef CPointerHandleBaseT<IDiscMaster2*, TImReleasePointerT<IDiscMaster2*> > CDiscMasterHandle

DiscMaster ハンドル

TnbImageMastering.h の 457 行目に定義があります。

◆ CDiscRecorderHandle

typedef CPointerHandleBaseT<IDiscRecorder2*, TImReleasePointerT<IDiscRecorder2*> > CDiscRecorderHandle

DiscRecorder ハンドル

TnbImageMastering.h の 460 行目に定義があります。

◆ CFileSystemImageHandle

typedef CPointerHandleBaseT<IFileSystemImage*, TImReleasePointerT<IFileSystemImage*> > CFileSystemImageHandle

FileSystemImage ハンドル

TnbImageMastering.h の 463 行目に定義があります。

構築子と解体子

◆ CImageMastering()

CImageMastering ( void )

コンストラクタ

TnbImageMastering.h の 2026 行目に定義があります。

関数詳解

◆ CheckRes()

bool CheckRes ( HRESULT hr ) const

protectedinherited

[設定] リザルトチェック.

リザルトコードをチェックし、記憶します。

引数

hr リザルトコード

戻り値

true	リザルトコードが「成功」だ
false	リザルトコードが「失敗」だ

TnbImageMastering.h の 420 行目に定義があります。

◆ CreateDrive()

CDrive CreateDrive ( INDEX index ) const

[取得] ドライブ管理クラス取得.

指定のドライブ管理クラスを取得します。書き込みをサポートしていないドライブの場合、無効なクラスが取得されます。

引数

index インデックス。０〜 GetDriveCount() 未満を指定出来ます。

戻り値: デバイス管理クラス. CDrive::IsValid() で、有効なクラスか確認できます。

TnbImageMastering.h の 2099 行目に定義があります。

◆ CreateStreamOnFile()

static HRESULT CreateStreamOnFile	(	LPCTSTR	lpszFile,
		DWORD	grfMode,
		IStream **	ppstm
	)

staticinherited

[作成] ファイルストリーム作成.

覚え書き: ::SHCreateStreamOnFile() をコールしているだけです。

引数

[in]	lpszFile	ファイル名
[in]	grfMode	モード
[out]	ppstm	ストリーム

戻り値: リザルト

TnbImageMastering.h の 391 行目に定義があります。

◆ GetDriveCount()

size_t GetDriveCount ( void ) const

[取得] ドライブ数取得.

覚え書き: 書き込みをサポートしていないドライブも数に含まれます。

戻り値: ドライブ数.

TnbImageMastering.h の 2056 行目に定義があります。

◆ GetDriveName()

CStr GetDriveName ( INDEX index ) const

[取得] ドライブ名取得.

覚え書き: "q:\\"などではありません。ドライブを示すユニークな文字列です。

引数

index インデックス。０〜 GetDriveCount() 未満を指定出来ます。

戻り値: ドライブ名.

TnbImageMastering.h の 2077 行目に定義があります。

◆ GetLastResult()

HRESULT GetLastResult ( void ) const

inherited

[取得] リザルトコード取得.

戻り値: リザルトコード.

TnbImageMastering.h の 326 行目に定義があります。

◆ GetLastResultString()

CStr GetLastResultString ( void ) const

inherited

[取得] リザルト文字列取得.

戻り値: リザルト文字列.

TnbImageMastering.h の 335 行目に定義があります。

◆ IsSupported()

bool IsSupported ( void ) const

[確認] サポート確認.

PCが本機能をサポートしているか、確認出来ます。

戻り値

true	サポートしている.
false	サポートしていない。

TnbImageMastering.h の 2036 行目に定義があります。

◆ ToString() [1/2]

static CStr ToString ( HRESULT hr )

staticinherited

[変換] リザルト文字列変換.

リザルトコードを文字列に変換

引数

hr リザルトコード

戻り値: 文字列

TnbImageMastering.h の 346 行目に定義があります。

◆ ToString() [2/2]

static CStr ToString ( IMAPI_MEDIA_PHYSICAL_TYPE type )

static

[取得] ディスク種類文字取得.

引数

type ディスク種類

戻り値: ディスク種類文字

TnbImageMastering.h の 2111 行目に定義があります。

クラス

公開型

公開メンバ関数

静的公開メンバ関数

限定公開メンバ関数

詳解

型定義メンバ詳解

◆ CDiscFormatDataHandle

◆ CDiscFormatEraseHandle

◆ CDiscMasterHandle

◆ CDiscRecorderHandle

◆ CFileSystemImageHandle

構築子と解体子

◆ CImageMastering()

関数詳解

◆ CheckRes()

◆ CreateDrive()

◆ CreateStreamOnFile()

◆ GetDriveCount()

◆ GetDriveName()

◆ GetLastResult()

◆ GetLastResultString()

◆ IsSupported()

◆ ToString() [1/2]

◆ ToString() [2/2]