Installazione di componenti driver personalizzati

Importante

È consigliabile usare il driver di classe IPP di Microsoft, insieme a Print Support Apps (PSA), per personalizzare l'esperienza di stampa in Windows 10 e 11 per lo sviluppo di dispositivi stampanti.

Per altre informazioni, vedere la guida alla progettazione dell'app di supporto stampa.

Quando si forniscono componenti personalizzati per i driver della stampante Microsoft, è necessario specificare anche un file di .ini per l'installazione del componente. Se la stampante non è supportata da ntprint.inf, è necessario specificare anche un file INF della stampante.

Il file .ini deve contenere una sezione OEMFiles. In questa sezione ogni componente personalizzato viene descritto usando una delle voci seguenti:

• OEMDriverFilen

  Assegna un nome a un plug-in di rendering.

• OEMConfigFilen

  Assegna un nome al plug-in dell'interfaccia utente.

dove n specifica l'ordine in cui il programma di installazione installa i file. I numeri specificati per n devono essere contigui, a partire da 1, per entrambi i tipi di plug-in.

Ad esempio, se si forniscono due plug-in di rendering e un plug-in dell'interfaccia utente e il modello di stampante è XYZ, il file di .ini potrebbe essere visualizzato come segue:

[OEMFiles]
OEMDriverFile1=XYZDRV1.DLL
OEMConfigFile1=XYZUI1.DLL
OEMDriverFile2=XYZDRV2.DLL

Gli spazi non sono consentiti prima o dopo il segno di uguale (=). I nomi di file non possono includere le specifiche del percorso.

Nell'esempio vengono specificati due plug-in di rendering. In base ai valori n per OEMDriverFilen, xyzdrv1.dll viene installato prima di xyzdrv2.dll. I driver Unidrv e Pscript5 chiamano plug-in nell'ordine in cui vengono installati, quindi in un secondo momento, quando un driver deve chiamare funzioni di hook DDI grafica e metodi COM forniti da questi plug-in, xyzdrv1.dll viene chiamato prima di xyzdrv2.dll.

Il nome del file .ini deve riflettere il nome del prodotto della stampante. Il nome del file .ini deve essere distinto dai nomi dei file di .ini per altre stampanti per evitare conflitti di nome. Se si esegue il back-porting di un plug-in di rendering o un plug-in dell'interfaccia utente a Windows NT 4.0, il nome del file .ini deve corrispondere al nome del file con estensione gpd o ppd. Ovvero, xyz.ini deve essere usato per xyz.gpd o xyz.ppd.) Questa restrizione non si applica a Windows 2000 o versioni successive del sistema operativo Windows.

Un file .ini può contenere testo ANSI o Unicode, ma il testo Unicode è consigliato. All'interno di un file .ini, le righe che iniziano con il segno di sterlina (#) sono commenti.

Per altre informazioni, vedere Linee guida generali per i file INF e Installazione di un minidriver unidrv.

Se si fornisce un file INF della stampante, è possibile installare e registrare un componente personalizzato consiste nel rendere il componente un file dipendente dal driver della stampante. Inoltre, il file con estensione inf associato può essere installato come file dipendente. Per altre informazioni sui file dipendenti per i driver della stampante, vedere Voci file INF stampante.

In alternativa, è possibile installare un componente personalizzato rendendo il componente un file dipendente per un altro componente di stampa, ad esempio un monitoraggio della porta o un'applicazione di stato. Tuttavia, questo metodo potrebbe creare difficoltà perché le operazioni di stampa e punto installano solo il driver e i file dipendenti dal driver nel client. Se un componente personalizzato non è elencato come file dipendente del driver della stampante, il componente deve essere installato nel client in qualche modo diverso da come parte dell'operazione di stampa e punto.