Sdílet prostřednictvím

Manifest ovladače V4

Important

Moderní tisková platforma je upřednostňovaná pro komunikaci s tiskárnami ve Windows. Doporučujeme použít ovladač třídy doručené pošty IPP od Microsoftu spolu s tiskovými podpůrnými aplikacemi (PSA) k přizpůsobení prostředí tisku ve Windows 10 a 11 pro vývoj zařízení tiskárny.

Další informace najdete v průvodci návrhem aplikace podpory tisku v1 a v2.

Manifest ovladače tisku v4 je textový soubor, který obsahuje všechny direktivy nastavení specifické pro tiskárnu. Manifest ovladače tisku v4 se používá se souborem INF ovladače tisku v4, který je součástí nastavení pro ovladač tisku specifické pro tiskárnu v4.

Direktivy v manifestu jsou uspořádány do oddílů:

Oddíl DriverConfig

Následující tabulka uvádí direktivy, které se používají v části DriverConfig.

Directive Restrictions Usage
RequiredFiles

Obsahuje soubory z ntprint.inf nebo ntprint4.inf.

Direktiva RequiredFiles podporuje ve Windows 10 následující hodnotu:

PWGRRenderFilter.dll: Přidá do seznamu závislých souborů ovladače filtr vykreslování Raster od Microsoft PWG.

Vykreslovací filtr VYKRESLOVÁNÍ PWG Raster vyžaduje, aby ovladač pro konfiguraci používal soubor PrintDeviceCapabilities.		 Unidrv.dll, pscript5.dlla mxdwdrv.dll by měly být z tohoto seznamu vynechány. Automaticky se vyřeší. Examples:

RequiredFiles=
UNIRES.DLL,
STDNAMES. GPD
V3HOSTINGFILTER.DLL
RequiredClass

Způsobí, že tento ovladač zahrne všechny soubory z definovaného ovladače třídy pomocí popisného názvu zařízení a jeho IDENTIFIKÁTOR GUID jako klíče. Toto je mechanismus pro propojení ovladače printclass s konkrétním ovladačem modelu.		 Direktivu RequiredClass nelze použít ovladačem třídy. Při použití RequiredClass byste se měli vyhnout kolizím názvů souborů mezi ovladačem tiskárny a ovladačem Třídy tisku, ke kterému propojíte.

I když se soubory s podobnými názvy navzájem nepřepíší, může být obtížné při řešení potíží rozlišovat mezi souborem balíčku ovladače třídy a souborem od ovladače tiskárny v4.		 Example:

RequiredClass=
"Ovladač třídy Fabrikam PCL5e",(9343720D-B67E-4451-B93F-6F721C439771)
DriverFile

To odkazuje na binární soubor vykreslování. Mxdwdrv je výchozí, ale ovladače třídy mohou alternativně určit unidrv.dll nebo pscript5.dll. Toto je funkčně stejné direktivě v inf v3.		 Lze nastavit pouze v ovladači třídy. Platné volby jsou unidrv.dll nebo pscript5.dll. Ovladače tisku V4 buď dědí z třídy RequiredClass, nebo ve výchozím nastavení mxdwdrv.dll DriverFile=unidrv.dll
Datafile

Tím se definuje primární GPD nebo PPD pro tento ovladač. Toto je funkčně stejné direktivě v inf v3.

Ve Windows 10 můžou ovladače tisku verze 4 nadále zadávat GPD nebo PPD DataFile, ale mohou také popsat datový soubor, který je ve formátu PrintDeviceCapabilities.		 Required. Examples:

DataFile=FAPDL.gpd
DataFile=FAPDL.xml
DataFileType

DataFileType se musí použít při popisu souboru PrintDeviceCapabilities jako DataFile a může být také použit s GPD nebo PPD-based DataFile.		 Požadováno pro soubor PrintDeviceCapabilities. Example:

DataFileType=
"application/vnd.ms-PrintDeviceCapabilities+xml"
Flags

Slouží k určení volitelných atributů přidružených k ovladači.

NotShareable: Tento příznak určuje, že ovladač není možné sdílet. To je vhodné pro virtuální ovladače, jako je microsoft XPS Document Writer.

SoftResetOnJobCancellation: Tento příznak určuje, že zařízení při zrušení tiskové úlohy vyžaduje obnovitelné resetování USB (IOCTL_USBPRINT_SOFT_RESET). ArchiveEnabled Ovladač v4 používá tento příznak k vyžádání souboru XPS optimalizovaného pro archivaci jako soubor fondu.		 None. Examples:

Příznaky=
NotShareable,
SoftResetOnJobCancellation
Příznaky=
ArchiveEnabled, NotShareable
PrinterDriverID

Toto je jedinečné ID, které popisuje ovladač tisku. Pokud dva ovladače určují stejný Identifikátor PrinterDriverID, musí být kompatibilní pro sdílení a podporu stejných rozšíření tiskárny.		 Required. PrinterDriverID=
{guid}
PropertyBag

Určuje pro tento ovladač tašku vlastností řidiče. Toto je kompilovaný soubor vygenerovaný DriverPropertyBagTool.exe nebo sadou Visual Studio.		 None. PropertyBag=
FAProperty.dpb
ResourceFile

Definuje název knihovny DLL prostředků řetězce ovladače.

Ve Windows 10 můžou ovladače zadat soubor ResourceFile pomocí formátu .resx.		 None. Examples:

ResourceFile=
FARC.dll
ConstraintScript

Definuje název souboru omezení JavaScriptu ovladače.		 None. ConstraintScript=
FAConst.js
DriverCategory

Definuje kategorii zařízení mezi jednou z několika možností. Platné možnosti jsou následující:
PrintFax.Fax PrintFax.Printer PrintFax.Printer.3D PrintFax.Printer.File PrintFax.Printer.Service PrintFax.Printer.Virtual		 Required. DriverCategory=
PrintFax.Printer

Další informace o jiných kategoriích ovladačů naleznete v tématu Položky souboru INF tiskárny.
PrinterExtensionUrl

Určuje adresu URL, která má uživatel získat kopii aplikace rozšíření tiskárny. Používá se při sdílení tiskárny.		 None. PrinterExtensionUrl=
";https://www.fabrikam.com/files/setup.exe"
DevModeMap

Určuje soubor mapování Devmode. Jedná se o soubor XML, který se používá s převodem PrintTicket na DEVMODE v kódu JavaScriptu.		 None. DevModeMap=
fadmmap.xml
Soubor událostí

Určuje soubor XML události ovladače.		 None. EventFile=
faevents.xml
QueueProperties

Určuje formát tašky vlastností fronty. Toto je soubor XML a nesmí být kompilován.		 None. QueueProperties=
faQueueProps.xml
BidiUSBStatusInterface

Určuje seznam hardwarových ID, která odpovídají jednomu nebo více rozhraním zařízení, která se mají použít pro komunikaci USB Bidi.		 Žádné, ale mělo by být podporováno pouze v případě, že se stav provádí přes rozhraní USB, které není tiskové rozhraní. BidiUSBStatusInterface=
"USB\vid_1234&pid_1234",
"USB\vid_1234&pid_4567"
UserPropertyBagScope

Tato direktiva určuje rozsah kontejneru vlastností uživatele jako Fronta nebo Výrobce.
Pokud je tato direktiva vynechána, fronta je výchozí hodnota. Platné možnosti pro tuto direktivu jsou následující:

Fronta: Toto je výchozí konfigurace a odpovídá chování systému Windows 8. Výrobce: Všechny fronty, které používají stejný řetězec Výrobce v INF, používají stejnou tašku vlastností uživatele.		 None. UserPropertyBagScope=
Manufacturer
RetrievePrintDeviceCapabilitiesFromDevice

Ovladače v4 můžou určit, že musí načíst soubor PrintDeviceCapabilities z tiskáren WS-Print v2.0, pokud nastaví soubor PrintDeviceCapabilities jako datový soubor ovladače a typ DataFile také indikuje, že datový soubor je typu MIME "application/vnd.ms-PrintDeviceCapabilities+xml".

Platné možnosti:

True: Umožňuje nahrazení místního datového souboru ovladače souborem PrintDeviceCapabilities ze zařízení.

Ne: Místní datový soubor ovladače nebude nahrazen souborem PrintDeviceCapabilities ze zařízení.

Pokud není zadána, výchozí hodnota této direktivy je false.		 None. Example:

RetrievePrintDeviceCapabilitiesFromDevice=
true

Oddíl BidiFiles

Oddíl BidiFiles slouží k definování souborů s příponou Bidi. Je stejný jako formát Windows 7 pro TCP a WSD. Klíčová slova USB jsou nová.

Následující tabulka uvádí direktivy, které se používají v části BidiFiles.

Directive Restrictions Usage
BidiSPMFile
Tím se definuje soubor s příponou Bidi pro tiskárnu založenou na protokolu TCP/IP.		 None. BidiSPMFile=FaBidiSPM.xml
BidiWSDFile
Tím se definuje soubor s příponou Bidi pro tiskárnu založenou na WSD.		 None. BidiWSDFile=FABidiWSD.xml
BidiUSBFile
Tím se definuje rozšíření Bidi pro USB.		 None. BidiUSBFile=FABidiUSB.xml
BidiUSBJSFile
Tím se definuje rozšíření JavaScriptu pro USB.		 None. BidiUSBJSFile=FABidiUSBJS.js

Oddíl DriverRender

Následující tabulka uvádí direktivy, které se používají v části DriverRender.

Directive Restrictions Usage
PageOutputQuality. [OptionName]
Změní kompresi obrázku na základě hodnoty v úloze PrintTicket pro PageOutputQuality.		 OptionName musí být název zadaný ve standardním oboru názvů PrintSchema. PageOutputQuality.Draft=
MxdcImageType.JPEGHigh

PageOutputQuality.Normal=
MxdcImageType.JPEGMedium

PageOutputQuality.High=
MxdcImageType.PNG
XpsFormat
Změní formát XPS vygenerovaný tiskem pro tento ovladač. Je možné zadat více hodnot a pořadí představuje předvolbu řidiče.		 Není k dispozici pro použití v ovladačích tříd, které používají vykreslování Unidrv/PScript. XpsFormat=XPS

XpsFormat=OpenXPS

XPSFormat=OpenXPS,XPS

XPSFormat=XPS,OpenXPS
Výstupní formát
Direktiva OutputFormat popisuje jeden PDL, který je generován tímto ovladačem pomocí typu MIME.
Tyto informace se používají během operace CreateJob nebo CreateJob2 pro tiskárny WSD.		 None. Mezi platné typy použití patří:

OutputFormat=
"application/oxps"

OutputFormat=
"application/vnd.ms-xpsdocument"

OutputFormat=
"image/pwg-raster"

OutputFormat=
"application/vnd.ms-3mfdocument"

Zde může být zadán také jakýkoli jiný platný definovaný typ MIME.

Klíčové slovo MxdcImageType pro direktivu PageOutputQuality má následující povolené hodnoty:

Hodnota MxdcImageType
MxdcImageType.JPEGHigh
Vysoká komprese JPEG (menší soubory)
MxdcImageType.JPEGMedium
Střední komprese JPEG
MxdcImageType.JPEGLow
Nízká komprese JPEG
MxdcImageType.PNG
Typ souboru PNG (největší soubory)

Oddíl Ukládání souborů

Tato část podporuje scénář ukládání souborů. Pokud je ovladač tisku v4 nainstalován proti novému typu portu PORTPROMPT, tato část určuje přípony souborů, které se mají zobrazit v okně Common File , a také určuje lokalizovatelné řetězce prostředků, které podporují rozšíření a samotné dialogové okno.

Directive Restrictions Usage
<FileExtensionName>
Tato direktiva popisuje FileExtension, která se má použít při ukládání souboru z tohoto ovladače pomocí portu PORTPROMPT. Hodnota je RESOURCEID ze souboru ResourceFile ovladače. Pouze pro XPS a OXPS je možné zadat ID prostředku 0 a zařazování tisku bude pro tyto prostředky používat jeho interní prostředky.		 None. <FileExtensionName>=
<RESOURCEID>
Xps=1234
SaveAsTitle
Tato direktiva popisuje název, který se má použít v dialogovém okně Uložit soubor. Hodnota je RESOURCEID ze souboru ResourceFile ovladače.		 None. SaveAsTitle=
<RESOURCEID>
SaveAsTitle=4321

Oddíl PrinterExtensions

Oddíl PrinterExtensions určuje rozšíření tiskárny a režimy vyvolání, které podporuje. U obou těchto položek se aplikace automaticky zaregistruje v tiskovém systému. Kromě toho je aplikace nakonfigurovaná se dvěma různými parametry: PrinterDriverID a ReasonID v daném pořadí. V důsledku toho musí každá položka používat jiný identifikátor GUID PrinterExtensionID.

Následující tabulka uvádí direktivy, které se používají v části PrinterExtensions.

Directive Restrictions Usage
DriverEvent
Aplikace obsluhuje režim DriverEvent.		 None. DriverEvent=
app.exe,{extensionID GUID}
PrintPreferences
Aplikace obsluhuje režim PrintPreferences.		 None. PrintPreferences=
app.exe, {extensionID GUID}

Následuje ukázka manifestu ovladače tisku v4.

[DriverConfig]
DataFile=FAPDL.xml
RequiredFiles=UNIRES.DLL,STDNAMES.GPD,STDDTYPE.GDL,STDSCHEM.GDL,STDSCHMX.GDL,XPSSVCS.DLL,MSXPSINC.GPD,PWGRRenderFilter.DLL
ResourceFile=FARC.dll
PropertyBag=FAProperty.dpb
PrinterDriverID={GUID}
DriverCategory=PrintFax.Printer
ConstraintScript=faconst.js
EventFile=faevents.xml
PrinterExtensionUrl="https://www.fabrikam.com/download.asp?uiapp=120"
UserPropertyBagScope=Manufacturer
DataFileType="application/vnd.ms-PrintDeviceCapabilities+xml"
RetrievePrintDeviceCapabilitiesFromDevice=true

[BidiFiles]
BidiSPMFile=FABidiSPM.xml
BidiWSDFile=FABidiWSD.xml
BidiUSBFile=FaBidiUSB.xml
BidiUSBJSFile=FABidiUSBJS.js

[DriverRender]
PageOutputQuality.Draft=MxdcImageType.JPEGHigh
PageOutputQuality.Normal=MxdcImageType.JPEGMedium
PageOutputQuality.High=MxdcImageType.PNG
OutputFormat="image/pwg-raster"

[PrinterExtensions]
DriverEvent=FAapp.exe,{GUID}
PrintPreferences=FAapp.exe,{GUID2}

Položky souboru INF tiskárny

  • Last updated on