共用方式為

OEMCUIPPARAM 結構 (printoem.h)

  • 發行項

OEMCUIPPARAM 結構是做為使用者介面外掛程式 IPrintOemUI：：CommonUIProp 方法的輸入參數。

語法

typedef struct _OEMCUIPPARAM {
  DWORD           cbSize;
  POEMUIOBJ       poemuiobj;
  HANDLE          hPrinter;
  PWSTR           pPrinterName;
  HANDLE          hModule;
  HANDLE          hOEMHeap;
  PDEVMODE        pPublicDM;
  PVOID           pOEMDM;
  DWORD           dwFlags;
  POPTITEM        pDrvOptItems;
  DWORD           cDrvOptItems;
  POPTITEM        pOEMOptItems;
  DWORD           cOEMOptItems;
  PVOID           pOEMUserData;
  OEMCUIPCALLBACK OEMCUIPCallback;
} *POEMCUIPPARAM, OEMCUIPPARAM;

成員

cbSize

OEMCUIPPARAM 結構的大小。 由 Unidrv 或 Pscript5 驅動程式提供。

poemuiobj

OEMUIOBJ 結構的指標。

hPrinter

印表機的句柄。 由 Unidrv 或 Pscript5 驅動程式提供。

pPrinterName

包含印表機名稱的字串。 由 Unidrv 或 Pscript5 驅動程式提供。

hModule

使用者介面外掛程式的句柄。 由 Unidrv 或 Pscript5 驅動程式提供。

hOEMHeap

透過呼叫heapAlloc函式 (Microsoft Windows SDK 檔) 中所述，呼叫可配置空間的堆積句柄。 由 Unidrv 或 Pscript5 驅動程式提供。

pPublicDM

印表機公用 DEVMODEW 結構的指標。 只有在 IPrintOemUI：：CommonUIProp 方法的 dwMode 自變數OEMCUIP_DOCPROP時才有效。 由 Unidrv 或 Pscript5 驅動程式提供。

pOEMDM

使用者介面外掛程式私人 DEVMODEW 成員的指標。 只有在 IPrintOemUI：：CommonUIProp 方法的 dwMode 自變數OEMCUIP_DOCPROP時才有效。 由 Unidrv 或 Pscript5 驅動程式提供。

dwFlags

對於 IPrintOemUI：：CommonUIProp 的呼叫，其 dwMode 參數設定為 OEMCUIP_DOCPROP

包含印表機驅動程式DrvDocumentPropertySheets函式所接收之 DOCUMENTPROPERTYHEADER 結構的 fMode 成員內容。

對於 IPrintOemUI：：CommonUIProp 的呼叫，其 dwMode 參數設定為 OEMCUIP_PRNPROP

包含印表機驅動程式DrvDevicePropertySheets函式所接收DEVICEPROPERTYHEADER結構的 Flags 成員內容。

pDrvOptItems

印表機驅動程式 OPTITEM 陣列的指標。 第一次呼叫 IPrintOemUI：：CommonUIProp 時無效。 由 Unidrv 或 Pscript5 驅動程式提供。

cDrvOptItems

pDrvOptItems 所指向數位中的 OPTITEM 結構計數。 由 Unidrv 或 Pscript5 驅動程式提供。

pOEMOptItems

OPTITEM 結構的陣列指標。 由 IPrintOemUI：：CommonUIProp 呼叫端提供。 第二次呼叫 IPrintOemUI：：CommonUIProp 方法時，它必須放置此陣列中使用者介面外掛程式所定義的 OPTITEM 結構，而且必須將結構計數放在 cOEMOptItems 中。 對於放置於陣列中的每個 OPTITEM 結構，您必須執行下列動作：

  • 將 OPTITEM 結構的 DMPubID 成員設定為其中一個預先定義的值，或設定為大於DMPUB_USER的值。 如果您使用任何預先定義的值，則必須搜尋整個 OPTITEM 陣列中已包含這些值的結構，而且您必須設定其OPTIF_HIDE旗標。

  • 使用 OEMCUIPPARAM 結構 hOEMHeap 成員中包含的句柄，呼叫 Windows SDK HeapAlloc 函式來配置 OPTTYPES 和 OPTPARAMS 結構的空間。 印表機驅動程式不再需要時，會解除分配此空間。

第一次呼叫 IPrintOemUI：：CommonUIProp 時無效。

cOEMOptItems

pOEMOptItems 所指向數位中包含的OPTITEM結構計數。 由 Unidrv 或 Pscript5 驅動程式提供。

第一次呼叫 IPrintOemUI：：CommonUIProp 方法時， cOEMOptItems 的呼叫端提供值為零。 IPrintOemUI：：CommonUIProp 方法必須變更此值，以指出方法提供的 OPTITEM 結構數目。 第二次呼叫時， IPrintOemUI：：CommonUIProp 必須提供實際新增至 pOEMOptItems 所指向數位的 OPTITEM 結構數目。

pOEMUserData

由 IPrintOemUI：：CommonUIProp 方法使用，第二次呼叫它時，為 OEMCUIPCallback 函式提供選擇性的額外輸入資訊。

OEMCUIPCallback

第二次呼叫 IPrintOemUI：：CommonUIProp 方法使用，以傳回 OEMCUIPCALLBACK 類型的回呼函式位址。

備註

使用者介面外掛程式會接收此結構的位址作為 其 IPrintOemUI：：CommonUIProp 方法及其 OEMCUIPCALLBACK 型別回呼函式的輸入自變數。

如需使用此結構和相關聯函式的其他資訊，請參閱 使用者介面外掛程式。

規格需求

需求 值
標頭 printoem.h (包含 Printoem.h)