IPrintOemPS::Command-Methode (prcomoem.h)

Die IPrintOemPS::Command-Methode wird verwendet, um Plug-Ins für den Microsoft PostScript-Druckertreiber zu rendern, um PostScript-Befehle in den Datenstrom des Druckauftrags einzufügen.

Syntax

HRESULT Command(
        PDEVOBJ   pdevobj,
        DWORD     dwIndex,
        PVOID     pData,
        DWORD     cbSize,
  [out] OUT DWORD *pdwResult
);

Parameter

pdevobj

Vom Aufrufer bereitgestellter Zeiger auf eine DEVOBJ-Struktur .

dwIndex

Vom Aufrufer bereitgestellter Wert, der den aktuellen Einschleuspunkt innerhalb des Datenstroms des Druckauftrags darstellt. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

pData

Nicht verwendet.

cbSize

Nicht verwendet.

[out] pdwResult

Empfängt einen von der Methode bereitgestellten Wert, der das Ergebnis des Einfügevorgangs angibt. Wenn die Einfügung erfolgreich ist, sollte dieser Wert ERROR_SUCCESS werden. Wenn die Einfügung fehlschlägt, sollte der Wert einer der in winerror.h definierten Fehlercodes sein. Wenn die Methode nicht versucht, Daten für einen angegebenen dwIndex-Wert einzufügen, sollte der Wert ERROR_NOT_SUPPORTED werden.

Rückgabewert

Die -Methode muss einen der folgenden Werte zurückgeben.

Hinweise

Die IPrintOemPS::Command-Methode wird verwendet, um PostScript-Befehle in den Datenstrom einzufügen, der vom Microsoft PostScript-Druckertreiber generiert wird. Wenn Sie diese Methode bereitstellen möchten, müssen Sie sie in einem Rendering-Plug-In definieren.

Wenn die IPrintOemPS::Command-Methode aufgerufen wird, gibt ihr dwIndex-Parameter den aktuellen Injektionspunkt innerhalb des Datenstroms des Druckauftrags an. Die -Methode sollte diesen Wert verwenden, um zu bestimmen, welcher Vorgang ggf. ausgeführt werden soll. Indexwerte, die in wingdi.h definiert sind, sind in der folgenden Tabelle aufgeführt.

Die IPrintOemPS::Command-Methode muss IPrintOemDriverPS::D rvWriteSpoolBuf aufrufen, um die PostScript-Befehle einzufügen.

Wenn IPrintOemPS::Command-Methoden von mehreren Rendering-Plug-Ins exportiert werden, werden die Methoden in der Reihenfolge aufgerufen, in der die Plug-Ins für die Installation angegeben werden, jedes Mal, wenn der Druckertreiber einen Einschleuspunkt erreicht. Es gelten die folgenden Regeln:

• Wenn der Einschleuspunkt einer ist, für den die bereitgestellten Daten an die vom Druckertreiber bereitgestellten Daten angefügt werden, wird jedes Plug-In aufgerufen, und jedes Plug-In darf PostScript-Befehle anfügen.

• Wenn der Einschleuspunkt einer ist, für den die bereitgestellten Daten die vom Druckertreiber bereitgestellten Daten ersetzen, werden die Plug-Ins aufgerufen, bis eine IPrintOemPS::Command-Methode ERROR_SUCCESS für dwResult bereitstellt. Es werden keine anderen Plug-Ins aufgerufen. Wenn alle Plug-Ins ERROR_NOT_SUPPORTED bereitstellen, werden die vom Treiber bereitgestellten Daten nicht ersetzt.

• Wenn der Einschleuspunkt einer ist, für den die angegebenen Daten die vom Druckertreiber bereitgestellten Daten ersetzen, und wenn eine Anwendung die vom Treiber bereitgestellten Daten bereits mithilfe der POSTSCRIPT_INJECTION Drucker escape-Funktion ersetzt hat, werden keine Plug-Ins aufgerufen.

Anforderungen