CreateDC

"lpszDrive

函式功能

函式通過使用指定的名字為一個設備創建設備上下文環境。

函式原型

HDC CreateDC(LPCTSTR lpszDrive, LPCTSTR lpszDevice, LPCTSTR lpszOutput, CONST DEVMODE *lplnitData);

主要參數

lpszDriver:
Windows NT:指向一個以Null結尾的字元串的指針,該字元串為顯示驅動指定DISPLAY或者指定一個列印驅動程式名,通常為WINSPOOL。
Windows 95和Windows 98:在基於32位的應用程式中,該參數被忽略或者為Null。但有一個例外,可以通過指定以null結尾的DISPLAY來得到一個顯示設備上下文環境,如果該參數為DISPLAY。其他所有的參數必須為Null。
lpszDevice:指向一個以null結尾的字元串的指針,該字元串指定了正在使用的特定輸出設備的名字,它不是印表機模式名。LpszDevice參數必須被使用。
lpszOutput:該參數在32位套用中被忽略;並置為Null,它主要是為了提供與16位應用程式兼容,更多的信息參見下面的注釋部分。
LplnitData:指向包含設備驅動程式的設備指定初始化數據的DEVMODE結構的指針,DocumentProperties函式檢索指定設備獲取已填充的結構,如果設備驅動程式使用用戶指定的預設初始化值。則lplnitData參數必須為Null。
返回值:成功,返回值是特定設備的設備上下文環境的句柄;失敗,返回值為Null。
Windows NT:若想獲得更多錯誤信息,可調用GetLastError函式。
注釋:16位的Windows應用程式使用lpszOutput參數指定一通訊口的名字或者指定列印到檔案,基於32位的Windows應用程式不需要指定通訊口的名字,32位應用程式使可以通過調用StartDoc函式來完成列印到檔案的功能,在調用StartDoc函式時,使用DOCINFO結構。該結構的lpszOutput成員指定了輸出檔案名稱的路徑。當不再需要該設備上下文環境時可調用DeleteDC函式刪除它。
ICM:通過設定DEVMODE結構(由plnitDufa參數指定)的dmlCMMethod元素為合適值,可使ICM激活。
Windows CE:如果沒有給lpszDriver參數驅動程式名,則Windows返回一個顯示設備上下文環境,Windows CE忽略lpszDevice參數,Windows CE把lplnitData和lpszOutput參數傳送給驅動程式而不做任何修改。
速查:Windows NT:3.1及以上版本;Windows:95及以上版本;Windows CE:2.0及以上版本;頭檔案:wingdi.h;庫檔案:gdi32.lib,Unicode:在Windows NT上實現為Unicode和ANSI兩種版本。

相關詞條

相關搜尋

熱門詞條

聯絡我們