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