CreateICW 関数 (wingdi.h)

[アーティクル]
03/13/2024

CreateIC 関数は、指定されたデバイスの情報コンテキストを作成します。情報コンテキストを使用すると、デバイスコンテキスト (DC) を作成せずに、デバイスに関する情報をすばやく取得できます。ただし、GDI 描画関数は、情報コンテキストへのハンドルを受け入れることができません。

構文

HDC CreateICW(
  [in] LPCWSTR        pszDriver,
  [in] LPCWSTR        pszDevice,
       LPCWSTR        pszPort,
  [in] const DEVMODEW *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 バージョンを自動的に選択します。エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	wingdi.h (Windows.h を含む)
Library	Gdi32.lib
[DLL]	Gdi32.dll