Metodo IPrintOemUni::CommandCallback (prcomoem.h)

Il IPrintOemUni::CommandCallback metodo viene usato per fornire comandi stampanti generati dinamicamente per stampanti supportate da Unidrv.

Sintassi

HRESULT CommandCallback(
        PDEVOBJ pdevobj,
        DWORD   dwCallbackID,
        DWORD   dwCount,
        PDWORD  pdwParams,
  [out] OUT INT *piResult
);

Parametri

pdevobj

Puntatore fornito dal chiamante a una struttura DEVOBJ .

dwCallbackID

Valore fornito dal chiamante che rappresenta l'attributo *CallbackID del comando della stampante nel file GPD della stampante. Per altre informazioni, vedere la sezione Osservazioni seguenti.

dwCount

Valore fornito dal chiamante che rappresenta il numero di elementi nella matrice a cui punta da pdwParams. Può essere 0.

pdwParams

Puntatore fornito dal chiamante a una matrice di parametri di dimensioni DWORD contenenti valori specificati dai comandi della stampante *Attributo Params nel file GPD della stampante. Per altre informazioni, vedere la sezione Osservazioni seguenti. Può essere NULL.

[out] piResult

Riceve un valore di risultato fornito dal metodo. Vedere la sezione Osservazioni seguenti.

Valore restituito

Il metodo deve restituire uno dei valori seguenti.

Codice restituito Descrizione
S_OK
Operazione completata.
E_FAIL
Operazione non riuscita
E_NOTIMPL
Il metodo non è implementato.

Commenti

Il IPrintOemUni::CommandCallback metodo viene usato dai plug-in di rendering per generare dinamicamente i comandi della stampante, per le stampanti supportate da Unidrv.

Se si vuole generare dinamicamente un comando stampante, è necessario includere un attributo *CallbackID e, facoltativamente, un attributo *Params , all'interno della voce *Command del comando nel file GPD della stampante. Per altre informazioni, vedere Comandi stampanti generati dinamicamente.

Quando Unidrv chiama il IPrintOemUni::CommandCallback metodo, fornisce il valore dell'attributo *CallbackID della voce *Command come parametro dwCallbackID . Inserisce anche il valore dell'attributo *Command entry *Params all'interno di una matrice DWORD e fornisce l'indirizzo della matrice come parametro pParams . La matrice contiene un set di valori di variabili standard definiti da Unidrv e il parametro dwCount specifica il numero di parametri contenuti nella matrice. Per altre informazioni sugli attributi, vedere Attributi dei comandi.

Il metodo deve usare il valore del parametro dwCallbackID per determinare il comando da elaborare. Per ogni comando supportato, il metodo deve essere a conoscenza del quale, se presente, le variabili standard sono state specificate dall'attributo *Params della voce *Command e in quale ordine.

Il metodo è responsabile della costruzione di un comando stampante e quindi dell'invio del comando al spooler di stampa chiamando il metodo IPrintOemDriverUni::D rvWriteSpoolBuf .

Il valore specificato per piResult deve sempre restituire zero a meno che il metodo non elabora un comando cursore. Per i comandi del cursore che spostano il cursore nella direzione o x, il metodo deve restituire la nuova posizione del cursore.

Il IPrintOemUni::CommandCallback metodo è facoltativo. Se un plug-in di rendering implementa questo metodo, il metodo IPrintOemUni::GetImplementedMethod deve restituire S_OK quando riceve "CommandCallback" come input.

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione prcomoem.h (include Prcomoem.h)