IPrintOemDriverUni：:D rvGetGPDData 方法 (prcomoem.h)

  • 發行項

方法 IPrintOemDriverUni::DrvGetGPDData 是由 Unidrv 驅動程式提供，讓轉譯外掛程式可以取得印表機 GPD 檔案中定義的數據。

語法

HRESULT DrvGetGPDData(
  PDEVOBJ pdevobj,
  DWORD   dwType,
  PVOID   pInputData,
  PVOID   pBuffer,
  DWORD   cbSize,
  PDWORD  pcbNeeded
);

參數

pdevobj

呼叫端提供的 DEVOBJ 結構指標。

dwType

呼叫端提供的旗標，指出所要求的 GPD 數據類型。 目前，下列旗標是唯一定義的旗標：

旗標 定義
GPD_OEMCUSTOMDATA 方法會傳回與 GPD 檔案的 *OEMCustomData 項目相關聯的字串。

pInputData

保留的。 必須為零。

pBuffer

呼叫端提供的緩衝區指標，以接收要求的資訊。

cbSize

呼叫端提供的大小，以位元組為單位，由 pBuffer 指向的緩衝區。

pcbNeeded

接收驅動程式提供的最小緩衝區大小，以位元組為單位，以位元組為單位，以包含要求的資訊。

傳回值

方法必須傳回下列其中一個值。

傳回碼 描述
S_OK
 作業成功。
E_FAIL
 作業失敗。
E_NOTIMPL
 此方法尚未實作。

備註

如果 pBuffer 和 cbSize 指定的緩衝區太小而無法接收要求的資訊，Unidrv 會在 由E_FAIL所指向的位置中提供所需的緩衝區大小、傳回E_FAIL，並將錯誤碼設定為ERROR_INSUFFICIENT_BUFFER。

規格需求

需求 值
目標平台 桌面
標頭 prcomoem.h (包括 Prcomoem.h)