IPrintOemUI::GetInfo 方法 (prcomoem.h)
使用者介面外掛程式的 IPrintOemUI::GetInfo
方法會傳回識別資訊。
語法
HRESULT GetInfo(
DWORD dwMode,
PVOID pBuffer,
DWORD cbSize,
PDWORD pcbNeeded
);
參數
dwMode
包含下列其中一個呼叫端提供的整數常數。
OEMGI_GETREQUESTEDHELPERINTERFACES
如果 IPrintOemUI::P ublishDriverInterface 方法應該使用參數 pIUnknown 指向實作 IPrintCoreHelperPS 介面或 IPrintCoreHelperUni 介面的物件,則方法必須將 OEMPUBLISH_IPRINTCOREHELPER 位旗標值寫入緩衝區 pBuffer。
OEMGI_GETSIGNATURE
方法必須傳回唯一的四位元組識別簽章。 外掛程式也必須將此簽章放在 OPTITEM 結構中,如 OEMCUIPPARAM 結構 pOEMOptItems 成員的描述中所述。
OEMGI_GETVERSION
方法必須將使用者介面外掛程式的版本號碼傳回為 DWORD。 版本格式是開發人員定義的。
pBuffer
呼叫端提供的記憶體指標配置來接收 dwMode 所指定的資訊。
cbSize
pBuffer 所指向之緩衝區的呼叫端提供大小。
pcbNeeded
呼叫端提供的位置指標,以接收 寫入 pBuffer 所指向之緩衝區的位元組數目。
傳回值
方法必須傳回下列其中一個值。
傳回碼 | 描述 |
---|---|
|
作業成功。 |
|
作業失敗。 |
|
此方法尚未實作。 |
備註
需要使用者介面外掛程式才能實 IPrintOemUI::GetInfo
作 方法,這個方法會在載入外掛程式之後立即呼叫。 方法應該藉由將它寫入 pBuffer 所指定的位址,並將傳回之資訊的大小以位元組為單位,傳回的資訊寫入 至由 dnsNeed 指定的位置來傳回指定的資訊。
如果 pBuffer 為 NULL,則方法應該只使用 azureNeeded 傳回儲存指定資訊所需的位元組數目。
如需建立及安裝使用者介面外掛程式的詳細資訊,請參閱 自定義 Microsoft 的印表機驅動程式。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | prcomoem.h (包括 Prcomoem.h) |