Přizpůsobené operace nastavení tiskárny

Důležitý

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.

Chcete-li poskytnout přizpůsobené operace nastavení tiskárny pro tiskárny nainstalované pomocí Ntprint.dll, výchozího instalačního programu třídy tiskárny pro Windows 2000 a novější, můžete do souboru INF tiskárny zahrnout záznam VendorSetup.

Opatrnost

Mějte na paměti, že VendorSetup je nyní zastaralý a neměl by ho používat žádný nový ovladač v3 nebo v4, které vyvíjíte. Toto téma je poskytováno pouze pro referenci nebo pro údržbu stávajících ovladačů v3, které již používají tuto direktivu INF.

Pokud chcete během instalace ovladače tiskárny zobrazit prvky uživatelského rozhraní, musíte použít položku VendorSetup INF. Měli byste však použít položku VendorSetup INF pouze v případě potřeby. Významnou nevýhodou je, že jeho použití brání běžnému uživateli v instalaci tiskárny s technologií Plug and Play (v tomto případě musí být uživatel správcem).

Zařízení není možné nainstalovat pomocí instalace na straně serveru, pokud je ovladač zařízení nepodepsaný, nebo když soubor INF ovladače (podepsaný nebo nepodepsaný) obsahuje položku VendorSetup INF. Když je ovladač nepodepsaný, instalační program přidá 0x8000 do pořadí, které by ovladač měl, pokud by to byl podepsaný ovladač. Pokud soubor INF ovladače obsahuje položku VendorSetup, instalační program určí, že instalace zařízení vyžaduje interakci uživatele (která nemůže nastat v instalaci na straně serveru) a zastaví instalaci.

Instalační program také zastaví instalaci na straně serveru, pokud je pořadí ovladače 0x8000 nebo větší. Instalace může pokračovat, když se uživatel s oprávněními správce přihlásí, kdy instalační program restartuje instalaci zařízení jako instalaci na straně klienta. Pro ovladač, jehož pořadí je 0x1000 nebo větší, a proto se neshoduje s ID hardwaru, instalační program spustí Průvodce nalezeným novým hardwarem v nové knihovně DLL zařízení, který vyzve uživatele k zadání ovladače pro instalaci.

Pokud soubor INF podepsaného ovladače obsahuje položku VendorSetup a pořadí ovladače je menší než 0x1000, instalační program nespustí Průvodce nalezeným novým hardwarem. Další informace naleznete v tématu Jak instalační program vybere ovladače.

Formát položky VendorSetup je následující:

VendorSetup= FileName, FunctionName

where FileName je název knihovny DLL obsahující instalační funkci a FunctionName je název funkce. Knihovna DLL musí být nainstalována v adresáři %windir%\system32. Instalační program třídy tiskárny volá instalační funkci v této knihovně DLL pouze v případě, že je tiskárna nainstalována pomocí modulu Plug and Play nebo Průvodce přidáním tiskárny. Nastavovací funkce se nevolá, pokud je nainstalován pouze ovladač (například pomocí Průvodce přidáním ovladače tiskárny).

Pokud chcete zkopírovat jeden nebo více souborů do adresáře %windir%\system32, můžete do oddílu INF DestinationDirs přidat název sekce definované autorem INF. V následujícím příkladu oddíl OEMVendorFiles obsahuje seznam všech souborů, které mají být zkopírovány.

[DestinationDirs]
OEMVendorFiles = 11
...
[OEMVendorFiles]
vendor.dll

Funkce zadaná FunctionName musí odpovídat následujícímu prototypu:

VOID WINAPI FunctionName(HWND hWnd, HINSTANCE hInstance, LPSTR lpszCmdLine, UINT nCmdShow);

where FunctionName je název instalační funkce. Parametry funkce a jejich popisy jsou uvedeny v následující tabulce.

Parametr	Popis
hWnd	Určuje popisovač nadřazeného okna.
hInstance	Určuje popisovač instance volajícího procesu.
lpszCmdLine	Určuje řetězec ANSI obsahující název nainstalované tiskárny. Tento řetězec je parsován funkcí FunctionName.
nCmdShow	Určuje způsob zobrazení okna. Příznaky, které řídí způsob zobrazení okna, jsou definovány v winuser.h.

Instalační program třídy tiskáren spustí funkci nastavení jako jeden z posledních kroků v procesu instalace.