Funzione Escape (wingdi.h)

La funzione Escape consente a un'applicazione di accedere alle funzionalità del dispositivo definite dal sistema non disponibili tramite GDI. Le chiamate di escape effettuate da un'applicazione vengono convertite e inviate al driver.

Sintassi

int Escape(
  [in]  HDC    hdc,
  [in]  int    iEscape,
  [in]  int    cjIn,
  [in]  LPCSTR pvIn,
  [out] LPVOID pvOut
);

Parametri

[in] hdc

Handle per il contesto del dispositivo.

[in] iEscape

Funzione di escape da eseguire. Questo parametro deve essere uno dei valori di escape predefiniti elencati in Osservazioni. Usare la funzione ExtEscape se l'applicazione definisce un valore di escape privato.

[in] cjIn

Numero di byte di dati a cui punta il parametro lpvInData . Può essere 0.

[in] pvIn

Puntatore alla struttura di input necessaria per l'escape specificato.

[out] pvOut

Puntatore alla struttura che riceve l'output da questo escape. Questo parametro deve essere NULL se non vengono restituiti dati.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è maggiore di zero, ad eccezione dell'escape della stampante QUERYESCSUPPORT , che verifica solo l'implementazione. Se l'escape non è implementato, il valore restituito è zero.

Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema.

Commenti

Nota Si tratta di una funzione di blocco o sincrona e potrebbe non restituire immediatamente. La velocità di restituzione di questa funzione dipende da fattori di runtime, ad esempio lo stato della rete, la configurazione del server di stampa e l'implementazione del driver della stampante, fattori difficili da prevedere durante la scrittura di un'applicazione. Chiamando questa funzione da un thread che gestisce l'interazione con l'interfaccia utente, l'applicazione potrebbe sembrare non rispondente.
 
L'effetto del passaggio di 0 per cbInput dipenderà dal valore di nEscape e dal driver che gestisce l'escape.

Dei escape della stampante originale, è possibile utilizzare solo i seguenti elementi.

Carattere speciale di escape Descrizione
QUERYESCSUPPORT Determina se un determinato escape viene implementato dal driver di dispositivo.
PASSTHROUGH Consente all'applicazione di inviare dati direttamente a una stampante.
 

Per informazioni sui caratteri di escape della stampante, vedere ExtEscape.

Utilizzare la funzione StartPage per preparare il driver della stampante per ricevere i dati.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione wingdi.h (include Windows.h)
Libreria Gdi32.lib
DLL Gdi32.dll

Vedi anche

AbortDoc

Proprietà documento

EndDoc

EndPage

ExtEscape

GetDeviceCaps

Funzioni dell'API spooler di stampa

PrinterProperties

Stampa

ResetDC

SetAbortProc

Startdoc

StartPage