CreateICA 関数 (wingdi.h)
CreateIC 関数は、指定されたデバイスの情報コンテキストを作成します。 情報コンテキストは、デバイス コンテキスト (DC) を作成せずにデバイスに関する情報を迅速に取得する方法を提供します。 ただし、GDI 描画関数は、情報コンテキストへのハンドルを受け入れることができません。
構文
HDC CreateICA(
[in] LPCSTR pszDriver,
[in] LPCSTR pszDevice,
LPCSTR pszPort,
[in] const DEVMODEA *pdm
);
パラメーター
[in] pszDriver
デバイス ドライバーの名前 (Epson など) を指定する null で終わる文字列へのポインター。
[in] pszDevice
印刷マネージャー (Epson FX-80 など) で示されているように、使用されている特定の出力デバイスの名前を指定する null で終わる文字列へのポインター。 プリンター モデル名ではありません。 lpszDevice パラメーターを使用する必要があります。
pszPort
このパラメーターは無視され、 NULL に設定する必要があります。 これは、16 ビット Windows との互換性のためにのみ提供されます。
[in] pdm
デバイス ドライバーのデバイス固有の初期化データを含む DEVMODE 構造体へのポインター。 DocumentProperties 関数は、指定したデバイスに対して入力されたこの構造体を取得します。 デバイス ドライバーがユーザーによって指定された既定の初期化 (存在する場合) を使用する場合、 lpdvmInit パラメーターは NULL である必要があります。
戻り値
関数が成功した場合、戻り値は情報コンテキストへのハンドルです。
関数が失敗した場合は、返される値は NULL です。
注釈
情報 DC が不要になったら、 DeleteDC 関数を呼び出します。
注意
wingdi.h ヘッダーは、CreateIC をエイリアスとして定義します。このエイリアスは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wingdi.h (Windows.h を含む) |
| Library | Gdi32.lib |
| [DLL] | Gdi32.dll |