Identifikátory rozhraní pro ovladače tiskárny

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.

Sada GUID je definována v prcomoem.h. Každý z těchto identifikátorů GUID je identifikátor rozhraní pro jedno z rozhraní COM používaných pro komunikaci mezi ovladači tiskárny (Unidrv a Pscript5) a moduly plug-in.

V systémech Windows 2000 a Windows XP jsou definovány následující identifikátory GUID:

IID_IPrintOemUIIID_IPrintOemUI2 (moduly plug-in Pscript5 UI v systému Windows XP a novějších verzích operačního systému Windows) IID_IPrintOemDriverUIIID_IPrintCoreUI2 (moduly plug-in Pscript5 UI v systému Windows XP a novějších verzích operačního systému Windows) IID_IPrintOemUniIID_IPrintOemUni2 (moduly plug-in pro vykreslování Unidrv v systému Windows XP a novějších verzích operačního systému Windows) IID_IPrintOemUni3 (Moduly plug-in pro vykreslování Unidrv v systému Windows Vista a novějších verzích operačního systému Windows) IID_IPrintOemDriverUni IID_IPrintOemPSIID_IPrintOemPS2 (moduly plug-in vykreslování Pscript5 v systému Windows XP a novějších verzích operačního systému Windows) IID_IPrintOemDriverPSIID_IPrintCorePS2 (moduly plug-in vykreslování Pscript5 v systému Windows XP a novějších verzích operačního systému Windows) Každý identifikátor GUID identifikuje jednu verzi jednoho rozhraní. Pokud je definována nová verze rozhraní, přidá se do seznamu nový identifikátor GUID.

Plug-in moduly uživatelského rozhraní a vykreslovací plug-in moduly musí identifikovat verze rozhraní, které podporují. Ovladač tiskárny (Unidrv nebo Pscript5) volá metodu IUnknown::QueryInterface (popsanou v dokumentaci k sadě Windows SDK) určující identifikátor rozhraní jako vstup. Pokud modul plug-in podporuje zadanou verzi, musí metoda vrátit ukazatel na rozhraní spolu s návratovým stavem S_OK. V opačném případě musí vrátit E_NOINTERFACE. Ovladač začíná identifikátorem rozhraní pro nejnovější verzi a pokračuje v volání QueryInterface s dřívějšími identifikátory verzí, dokud metoda nevrátí S_OK nebo ovladač nevyčerpá seznam identifikátorů verzí.

Podobně Unidrv a Pscript5 poskytují metody IUnknown::QueryInterface pro rozhraní COM IPrintOemDriverUI, IPrintCoreUI2, IPrintOemDriverUni, IPrintOemDriverPS nebo IPrintCorePS2 COM. Moduly plug-in by měly volat metodu QueryInterface příslušného rozhraní pro určení podporované verze rozhraní ovladače a přijmout ukazatel rozhraní.