英語で読む

次の方法で共有

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 ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして CreateIC を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー wingdi.h (Windows.h を含む)
ライブラリ Gdi32.lib
DLL Gdi32.dll

関連項目

DEVMODE の

DeleteDC の

デバイス コンテキスト関数の

デバイス コンテキストの概要

DocumentProperties

GetDeviceCaps の