CreateDCA 関数 (wingdi.h)
CreateDC 関数は、指定した名前を使用してデバイスのデバイス コンテキスト (DC) を作成します。
構文
HDC CreateDCA(
LPCSTR pwszDriver,
[in] LPCSTR pwszDevice,
LPCSTR pszPort,
[in] const DEVMODEA *pdm
);
パラメーター
pwszDriver
DISPLAY または特定のディスプレイ デバイスの名前を指定する null で終わる文字列へのポインター。 印刷の場合は、プリンター デバイスの lpszDriver
[in] pwszDevice
印刷マネージャー (Epson FX-80 など) で示されているように、使用されている特定の出力デバイスの名前を指定する null で終わる文字列へのポインター。 プリンター モデル名ではありません。 lpszDevice パラメーターを使用する必要があります。
ディスプレイの有効な名前を取得するには、EnumDisplayDevices
lpszDriver
システムに複数のモニターがある場合、CreateDC(TEXT("DISPLAY"),NULL,NULL,NULL) を呼び出すと、すべてのモニターをカバーする DC が作成されます。
pszPort
このパラメーターは無視され、NULL
[in] pdm
デバイス ドライバーのデバイス固有の初期化データを含む DEVMODE 構造体へのポインター。
DocumentProperties 関数は、指定したデバイスに対して入力されたこの構造体を取得します。
lpszDriver
戻り値
関数が成功した場合、戻り値は指定されたデバイスの DC へのハンドルです。
関数が失敗した場合、戻り値は NULL
備考
DC へのハンドルは、一度に 1 つのスレッドでのみ使用できることに注意してください。
lpszDriver
DC が不要になったら、DeleteDC 関数を呼び出します。
lpszDriver または lpszDevice
CreateDC
ICM: ICM を有効にするには、(pInitData パラメーターによって指される) DEVMODE 構造体の dmICMMethod メンバーを適切な値に設定します。
例
例については、「イメージのキャプチャ」を参照してください。
手記
wingdi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして CreateDC を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | wingdi.h (Windows.h を含む) |
| ライブラリ | Gdi32.lib |
| DLL | Gdi32.dll |
関連項目
DEVMODE の
DOCINFO を
DeleteDC の
EnumDisplayDevices の
複数のディスプレイ モニター を
StartDoc の