GdiGetSpoolFileHandle 関数 (winppi.h)
GdiGetSpoolFileHandle 関数は、印刷ジョブの EMF ファイルへのハンドルを返します。
構文
HANDLE GdiGetSpoolFileHandle(
LPWSTR pwszPrinterName,
LPDEVMODEW pDevmode,
LPWSTR pwszDocName
);
パラメーター
pwszPrinterName
ターゲット プリンターの名前を表す文字列への呼び出し元指定ポインター。 次の「解説」セクションを参照してください。
pDevmode
呼び出し元が指定した DEVMODEW 構造体へのポインター。 次の「解説」セクションを参照してください。
pwszDocName
印刷ジョブのドキュメント名への呼び出し元指定ポインター。 次の「解説」セクションを参照してください。
戻り値
操作が成功した場合、この関数はスプール ファイル ハンドルを返します。 それ以外の場合、関数は NULL を返します。
注釈
GdiGetSpoolFileHandle 関数は、印刷プロセッサの PrintDocumentOnPrintProcessor 関数内で使用するために、gdi32.dll によってエクスポートされます。
印刷プロセッサが GdiGetSpoolFileHandle を呼び出すときは、次の表に示すように引数を指定する必要があります。
| パラメーター | 引数 |
|---|---|
| pwszPrinterName | 印刷プロセッサの OpenPrintProcessor 関数で受け取ったプリンター名へのポインター。 |
| pDevmode | 印刷プロセッサの OpenPrintProcessor 関数によって受け取られた PRINTPROCESSOROPENDATA 構造体に含まれる DEVMODEW 構造体へのポインター。 |
| pwszDocName | 印刷プロセッサの PrintDocumentOnPrintProcessor 関数によって受け取られたドキュメント名ポインター。 |
印刷プロセッサは、他の GDI 印刷関数を呼び出す前に GdiGetSpoolFileHandle 関数を呼び出す必要があります。これは、返されるハンドルを他の関数に渡す必要があるためです。 関数は OpenPrinter を呼び出してプリンターへの接続を開き、CreateDC を呼び出して描画用のデバイス コンテキストを作成します。 印刷プロセッサは、 GdiGetDC を呼び出すことによって、デバイス コンテキストのハンドルを取得できます。
詳細については、「 印刷プロセッサでの GDI 関数の使用」を参照してください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| Header | winppi.h (Winppi.h を含む) |
| Library | Gdi32.Lib |
| [DLL] | Gdi32.dll |