CDC::CreateDC

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

指定デバイスに対するデバイスコンテキストを作成します。

BOOL CreateDC(
   LPCTSTR lpszDriverName,
   LPCTSTR lpszDeviceName,
   LPCTSTR lpszOutput,
   const void* lpInitData 
);

パラメータ

lpszDriverName
デバイスドライバのファイル名 (拡張子なし) を指定する NULL で終わる文字列 (例 : "EPSON") へのポインタ。このパラメータには、CString オブジェクトを渡すこともできます。
lpszDeviceName
サポートされる特定のデバイス名を指定する NULL で終わる文字列 (例 : "EPSON FX-80") へのポインタ。パラメータ lpszDeviceName は、モジュールが 1 つ以上のデバイスをサポートしているときに使用されます。このパラメータには、CString オブジェクトを渡すこともできます。
lpszOutput
物理出力メディア (ファイルや出力ポート) のファイル名またはデバイス名を指定する NULL で終わる文字列へのポインタ。このパラメータには、CString オブジェクトを渡すこともできます。
lpInitData
デバイスドライバのデバイス固有の初期化データを持つ DEVMODE 構造体へのポインタ。Windows の DocumentProperties 関数は、与えられたデバイスのデータを保持する構造体を取得します。コントロールパネルを使って指定した既定の初期化 (もしあれば) をデバイスドライバが使っているときは、パラメータ lpInitData は NULL にします。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

DEVMODE 構造体を使うときは、PRINT.H ヘッダーファイルが必要です。

デバイス名はコロン (:) で終わることを推奨しますが、省略もできます。Windows では、コロンで終わるデバイス名とコロンのないデバイス名が同じポートを指すように、終わりのコロンは取り除きます。ドライバ名とポート名の前後にスペースを付けることはできません。情報コンテキストに対しては、GDI 出力関数は使えません。