DOCUMENTPROPERTYHEADER 構造体 (winddiui.h)

DOCUMENTPROPERTYHEADER 構造体は、プリンター インターフェイス DLL の DrvDocumentPropertySheets 関数への入力パラメーターとして使用されます。

構文

typedef struct _DOCUMENTPROPERTYHEADER {
  WORD     cbSize;
  WORD     Reserved;
  HANDLE   hPrinter;
  LPTSTR   pszPrinterName;
  PDEVMODE pdmIn;
  PDEVMODE pdmOut;
  DWORD    cbOut;
  DWORD    fMode;
} DOCUMENTPROPERTYHEADER, *PDOCUMENTPROPERTYHEADER;

メンバー

cbSize

DOCUMENTPROPERTYHEADER 構造体のサイズ (バイト単位)。

Reserved

予約済み。 ゼロを指定してください。

hPrinter

プリンター ハンドル。

pszPrinterName

プリンターの名前を表す NULL で終わる文字列へのポインター。

pdmIn

DrvDocumentPropertySheets 関数がプリンター インターフェイス DLL の内部 DEVMODEW 構造体にコピーする必要がある入力 DEVMODEW 構造体へのポインター (該当する場合は、プロパティ シートが表示される前)。 DM_IN_BUFFERまたはDM_MODIFYが fMode で設定されていない場合、このポインターは NULL です。

pdmOut

DrvDocumentPropertySheets 関数がプリンター インターフェイス DLL の内部 DEVMODEW コンテンツをコピーする出力 DEVMODEW 構造体へのポインター (該当する場合は、プロパティ シートが表示された後)。 DM_OUT_BUFFERまたはDM_COPYが fMode で設定されていない場合、このポインターは NULL です。

cbOut

pdmOut がポイントするバッファーのサイズをバイト単位で指定します。 詳細については、「解説」を参照してください。

fMode

次の表に示す 1 つ以上のビット フラグ。 (フラグは、ヘッダー ファイル Wingdi.h と Winddiui.h で定義されています)。

解説

cbOut メンバーの入力値は、pdmOut メンバーが指すバッファーのサイズと必ずしも等しいとは限りません。 たとえば、DrvDocumentPropertySheets 関数の pPSUInfo パラメーターが NULL で、DOCUMENTPROPERTYHEADER 構造体の fMode メンバーが 0 の場合、または同じ構造体の pdmOut メンバーが NULL の場合、ドライバーは、プリンターの DEVMODEW 構造体の合計サイズ (パブリック構造体メンバーとプライベート構造体メンバーを含む) を cbOut メンバーに書き込む必要があります。 このような場合、ドライバーは cbOut メンバーを "書き込み専用" メンバーとして扱う必要があります。 したがって、DrvDocumentPropertySheets 関数が呼び出された場合、ドライバーは pdmOut メンバーが指すバッファーのサイズとして cbOut メンバーを使用しないでください。 Windows Driver Kit (WDK) に付属する "プロッター" サンプルは、 cbOut メンバーを正しく使用する方法を示しています。

要件

こちらもご覧ください

COMPROPSHEETUI

DEVMODEW

DrvDocumentPropertySheets

MSPLOT プロッター ドライバーのサンプル