DevQueryPrintEx 函式 (winddiui.h)
印表機介面 DLL 的 DevQueryPrintEx 函式會判斷指定的列印作業是否與印表機目前的設定相容,因此可以列印。
語法
BOOL DevQueryPrintEx(
[in, out] PDEVQUERYPRINT_INFO pDQPInfo
);
參數
[in, out] pDQPInfo
呼叫端提供的 DEVQUERYPRINT_INFO結構的指標 。
傳回值
如果列印作業可以列印,函式應該會傳回 TRUE;否則,它應該會傳回 FALSE。
備註
印表機介面 DLL 必須定義 DevQueryPrintEx 函式。 如果印表機屬性表的 [進階] 頁面上已核取 [保留不相符的檔] 選項,則列印後台處理程式會呼叫函式。 如果函式傳回 TRUE,多任務緩衝處理程式會將列印作業排入佇列以供列印。 否則,作業會保留,假設印表機最終會重新設定,讓作業可以列印。
收到的 DEVQUERYPRINT_INFO 結構指向 DEVMODEW 結構,描述列印作業所需的印表機特性。 DevQueryPrintEx 函式應該先確認所接收 DEVMODEW 結構的大小和版本成員與驅動程式相容。 然後,它應該判斷提供的 DEVMODEW 內容是否與目前的印表機設定相容。
如果可以列印作業,函式應該只會傳回 TRUE。 如果作業應保留到稍後,則函式在DEVQUERYPRINT_INFO結構的 pszErrorStr 成員所指向的緩衝區中提供可顯示文字字串 (之後,函式應該會傳回 FALSE,) 描述無法列印作業的原因。
可顯示的文字字串應該定義為資源檔中的字串資源。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | winddiui.h (包含Winddiui.h) |
程式庫 | Winspool.lib |
Dll | WinSpool.drv |