CDC::CreateDC

[アーティクル]
08/09/2011

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

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 出力関数は使えません。