createICA 函式 (wingdi.h)

CreateIC 函式會為指定的裝置建立信息內容。 信息內容可讓您快速取得裝置的相關信息,而不需建立裝置內容 (DC) 。 不過,GDI 繪圖函式無法接受資訊內容的句柄。

語法

HDC CreateICA(
  [in] LPCSTR         pszDriver,
  [in] LPCSTR         pszDevice,
       LPCSTR         pszPort,
  [in] const DEVMODEA *pdm
);

參數

[in] pszDriver

指定設備 (驅動器名稱的 null 終止字元字串指標,例如 Epson) 。

[in] pszDevice

指定所使用之特定輸出裝置名稱的 Null 終止字元字串指標, (例如,Epson FX-80) 所示。 它不是印表機型號名稱。 必須使用 lpszDevice 參數。

pszPort

此參數會被忽略,而且應該設定為 NULL。 它僅適用於與16位 Windows 的相容性。

[in] pdm

DEVMODE 結構的指標,其中包含裝置驅動程式的裝置特定初始化數據。 DocumentProperties 函式會擷取填入指定裝置的這個結構。 如果設備驅動器要使用預設初始化,則 lpdvmInit 參數必須是 NULL ,如果使用者指定任何) ,則為預設初始化 (。

傳回值

如果函式成功,傳回值就是信息內容的句柄。

如果函式失敗,則傳回值為 NULL

備註

當您不再需要DC資訊時,請呼叫 DeleteDC 函式。

注意

wingdi.h 標頭會將 CreateIC 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 wingdi.h (包含 Windows.h)
程式庫 Gdi32.lib
Dll Gdi32.dll

另請參閱

DEVMODE

DeleteDC

裝置內容函式

裝置內容概觀

DocumentProperties

GetDeviceCaps