共用方式為

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 結構的 旗標 成員的內容。

pDrvOptItems

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

cDrvOptItems

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

pOEMOptItems

OPTITEM 結構的陣列指標。 由 IPrintOemUI：：CommonUIProp 呼叫者提供。 第二次呼叫 IPrintOemUI：：CommonUIProp 方法時，它必須在此數位中放置 OPTITEM 結構，而且必須將結構計數放在 cOEMOptItems 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 （include Printoem.h）