Metodo IPrintCoreUI2::QuerySimulationSupport (prcomoem.h)

Articolo
02/07/2025

Il metodo IPrintCoreUI2::QuerySimulationSupport recupera una struttura di funzionalità di simulazione dello spooler, che indica i tipi di simulazione supportati dallo spooler.

Sintassi

HRESULT QuerySimulationSupport(
  [in]  HANDLE hPrinter,
  [in]  DWORD  dwLevel,
  [out] PBYTE  pCaps,
  [in]  DWORD  cbSize,
  [out] PDWORD pcbNeeded
);

Parametri

[in] hPrinter

Specifica un handle per la stampante.

[in] dwLevel

Specifica la struttura della funzionalità di simulazione dello spooler restituita nel buffer a cui punta pCaps. Attualmente viene fornito solo il livello 1 del supporto per la simulazione dello spooler.

Valore	Struttura di supporto simulazione Spooler
1	SIMULATE_CAPS_1 (definito in printoem.h)

[out] pCaps

Puntatore al buffer di output, che contiene una struttura del tipo indicato dal valore nel parametro dwLevel.

[in] cbSize

Specifica le dimensioni, in byte, del buffer di output a cui punta pCaps.

[out] pcbNeeded

Specifica le dimensioni, in byte, della memoria necessaria per archiviare una struttura del tipo indicato da dwLevel.

Valore restituito

Il metodo deve restituire uno dei valori seguenti.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_OUTOFMEMORY	Il valore in cbSize era inferiore al numero di byte da scrivere nel buffer di output (il buffer a cui punta pCaps). Il metodo è stato chiamato con pCaps impostato su NULL.
E_NOTIMPL	Il metodo non è supportato. Una struttura del tipo specificato da dwLevel non è supportata.
E_FAIL	Il metodo non è riuscito

Osservazioni

Questo metodo è supportato solo per i plug-in Pscript5 di Windows XP, non per i plug-in Unidrv.

Il metodo IPrintCoreUI2::QuerySimulationSupport archivia una struttura di funzionalità di simulazione dello spooler nel buffer a cui punta pCaps. Questa struttura specifica il livello di supporto dello spooler per la stampa "N-up", la stampa inversa, il numero massimo di pagine che possono essere stampate, regole di confronto e altre.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	prcomoem.h (include Prcomoem.h)

Vedere anche

IPrintCoreUI2

SIMULATE_CAPS_1

Condividi tramite