GdiStartDocEMF-Funktion (winppi.h)

  • Artikel

Die GdiStartDocEMF-Funktion führt Initialisierungsvorgänge für einen Druckauftrag im EMF-Format aus.

Syntax

BOOL GdiStartDocEMF(
  HANDLE   SpoolFileHandle,
  DOCINFOW *pDocInfo
);

Parameter

SpoolFileHandle

Vom Aufrufer bereitgestelltes Spooldateihandle, das durch einen vorherigen Aufruf von GdiGetSpoolFileHandle abgerufen wurde.

pDocInfo

Vom Aufrufer bereitgestellter Zeiger auf eine DOCINFOW-Struktur (in der Microsoft Window SDK-Dokumentation beschrieben).

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion TRUE zurück. Andernfalls gibt die Funktion FALSE zurück, und ein Fehlercode kann durch Aufrufen von GetLastError abgerufen werden.

Hinweise

Die GdiStartDocEMF-Funktion wird von gdi32.dll zur Verwendung in der PrintDocumentOnPrintProcessor-Funktion eines Druckprozessors exportiert.

Die Funktion führt Initialisierungen durch, die erfolgen müssen, bevor die EMF-Datensätze eines Druckauftrags wiedergegeben werden können. Die Funktion ruft die StartDoc-Funktion des Spoolers auf (in der Window SDK-Dokumentation beschrieben), die wiederum die DrvStartDoc-Funktion des Druckertreibers aufruft.

Der Druckprozessor muss das lpszOutput-Element der DOCINFOW-Struktur auf den In der PRINTPROCESSOROPENDATA-Struktur enthaltenen Ausgabedateinamen festlegen, der zuvor von der OpenPrintProcessor-Funktion empfangen wurde.

Der Druckprozessor muss das lpszDocName-Element der DOCINFOW-Struktur auf den Dokumentnamenzeiger festlegen, der zuvor von der PrintDocumentOnPrintProcessor-Funktion empfangen wurde.

Weitere Informationen finden Sie unter Verwenden von GDI-Funktionen in Druckprozessoren.

Anforderungen

Anforderung Wert
Zielplattform Universell
Header winppi.h (winppi.h einschließen)
Bibliothek Gdi32.Lib
DLL Gdi32.dll

Weitere Informationen

GdiEndDocEMF