CDC::CreateIC

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

指定されたデバイスの情報コンテキストを作成します。

BOOL CreateIC(
   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
デバイスドライバーのデバイス固有の初期化データへのポインター。コントロールパネルを使って指定した既定の初期化 (もしあれば) をデバイスドライバーが使っているときは、パラメーター lpInitData は NULL にします。デバイス固有の初期化データのフォーマットについては CreateDC を参照してください。

戻り値

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

解説

情報コンテキストを使用すると、デバイスコンテキストを作成せずにデバイスに関する情報をすばやく取得できます。

デバイス名にこれらの規則に従ってください。終了のコロン（:）オプションですがおすすめです。 Windows では、コロンで終わるデバイス名とコロンのないデバイス名が同じポートを指すように、終わりのコロンは取り除きます。ドライバー名とポート名の前後にスペースを付けることはできません。情報コンテキストに対しては、GDI 出力関数は使えません。