MXDC _ fonction d’échappement)

La fonction d’échappement de l’imprimante MXDC _ Escape permet aux applications d’écrire des documents dans un fichier ou sur une imprimante au format XPS (XML Paper Specification) au moyen de Microsoft XPS Document Converter (MXDC).

Pour effectuer cette opération, appelez la fonction ExtEscape avec les paramètres suivants.

Syntaxe

int MXDC_ESCAPE(
    hdc,
    cbInput,
    lpszInData,
    cbOutput,
    lpszOutData
);

Paramètres

HDC

Handle vers le contexte de périphérique d’impression.

cbInput

Taille, en octets, des données vers lesquelles pointe le paramètre lpszInData .

lpszInData

Pointeur vers une mémoire tampon contenant les données d’entrée, qui sont toujours stockées dans l’une des structures suivantes.

**MxdcEscapeHeader**
**MxdcPrintTicketEscape**
**MxdcS0PagePassthroughEscape**
**MxdcS0PageResourceEscape**

Chacune de ces structures a un membre opcode qui spécifie ce que le MXDC est supposé faire. Pour obtenir des remarques détaillées sur ces codes, consultez MxdcEscapeHeader.

Code d’opération (OpCode) Action
MXDCOP _ obtient le _ nom du fichier
Définit le paramètre lpszOutData de la fonction ExtEscape sur, soit le chemin d’accès complet du fichier de sortie comme une chaîne se terminant par zéro, soit la taille de cette chaîne.
_ _ _ Seq document fixe MXDCOP _ PRINTTICKET
Associe un ticket d’impression à une séquence de documents fixe XPS.
_ _ document fixe MXDCOP _ PRINTTICKET
Associe un ticket d’impression à un document XPS.
_ _ page fixe MXDCOP _ PRINTTICKET
Associe un ticket d’impression à une page XPS.
MXDCOP _ Set _ S0PAGE
Envoie le balisage XPS de la page actuelle à la sortie.
MXDCOP _ définir _ la _ ressource S0PAGE
Envoie une ressource sur la page, telle qu’une image ou une police, à la sortie.
MXDCOP _ définir _ le _ mode XPSPASSTHRU
Place le MXDC dans un État pass-through, permettant à une application d’écrire XPS directement dans le fichier de sortie sans aucun traitement de la MXDC. Un document entier ou même une séquence de documents peut être écrit de cette façon.

cbOutput

Taille, en octets, des données vers lesquelles pointe le paramètre lpszOutData .

lpszOutData

Pointeur vers une mémoire tampon contenant les données de sortie.

Valeur retournée

Si la fonction est réussie, la valeur de retour est supérieure à zéro. Si la fonction échoue ou n’est pas prise en charge, la valeur de retour est inférieure ou égale à zéro.

Remarques

Cette séquence d’échappement est prise en charge par MXDC et XPSDrv, mais pas par GDI.

Pour déterminer si le pilote d’imprimante est le MXDC, appelez ExtEscape avec l’échappement GETTECHNOLOGY . Si le pilote est le MXDC, ExtEscape retourne la chaîne se terminant par zéro « http://schemas.microsoft.com/xps/2005/06 ». Assurez-vous que la mémoire tampon référencée par le paramètre lpszOutData est suffisamment grande pour contenir cette chaîne.

pour déterminer si le pilote d’imprimante est le pilote Microsoft xps document writer intégré Windows, vérifiez que le pilote d’imprimante est le MXDC, puis déterminez si le nom du pilote d’imprimante est « Microsoft XPS Document writer ».

Pour connaître le nom du pilote d’imprimante, utilisez l’une des techniques suivantes.

Appelez GetPrinterDriver avec la valeur de paramètre Level définie sur 1. Le nom du pilote d’imprimante est retourné dans le membre pname de la structure _ informations sur le pilote _ 1 .
ou
Appelez GetPrinter avec la valeur de paramètre Level définie sur 2. Le nom du pilote d’imprimante est retourné dans le membre pDriverName de la structure Printer _ info _ 2 .

Le tableau suivant indique où trouver différents objets dans le fichier XPS. les différents types d’objets sont écrits.

Object Emplacement dans le fichier de sortie
Page fixe /Documents/1/Pages/Esc%d.fpage
Thumbnail /Documents/1/Metadata
Imprimer le ticket /Documents/1/Metadata
Police /Documents/1/Resources/Fonts
Image /Documents/1/Resources/Images

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows [Applications de bureau Vista uniquement]
Serveur minimal pris en charge
Windows Serveur 2008 [ applications de bureau uniquement]
En-tête
Mxdc. h

Voir aussi

Impression

Fonctions d’échappement d’imprimante

ExtEscape