Installazione di componenti driver personalizzati

Importante

La piattaforma di stampa moderna è il mezzo preferito di Windows per comunicare con le stampanti. Ti consigliamo di 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 per stampanti.

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

Quando si forniscono componenti personalizzati per i driver della stampante Microsoft, è necessario specificare anche un file .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 a un 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 apparire 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 specifiche di 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 i plug-in nell'ordine in cui sono installati, quindi in seguito, quando un driver deve chiamare funzioni di hook DDI grafiche 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 file .ini deve essere distinto dai nomi dei file di .ini per altre stampanti per evitare conflitti di nomi. Se si esegue il back-porting di un plug-in di rendering o di 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 è consigliabile usare testo Unicode. All'interno di un file .ini, le righe che iniziano con il segno di cancelletto (#) 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, un modo pratico per installare e registrare un componente personalizzato consiste nel rendere il componente un file dipendente del driver della stampante. Inoltre, il file inf associato può essere installato come file dipendente. Per altre informazioni sui file dipendenti per i driver della stampante, vedere Voci di file INF della stampante.

In alternativa, è possibile installare un componente personalizzato rendendo il componente un file dipendente per un altro componente di stampa, ad esempio un monitoraggio delle porte o un'applicazione di stato. Tuttavia, questo metodo potrebbe creare difficoltà perché le operazioni di puntamento e stampa installano solo i file dipendenti dal driver e 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 punto e stampa.