Funzione Escape (wingdi.h)

Articolo
03/08/2023

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