逸出函式 (wingdi.h)

Escape函式可讓應用程式存取無法透過 GDI 取得的系統定義裝置功能。應用程式發出的逸出呼叫會轉譯並傳送至驅動程式。

語法

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

[in] hdc

裝置內容的控制碼。

[in] iEscape

要執行的逸出函式。此參數必須是中列出的其中一個預先定義的逸出值。如果您的應用程式定義私用逸出值，請使用 ExtEscape 函式。

[in] cjIn

lpvInData參數所指向的資料位元組數目。這可以是 0。

[in] pvIn

指定逸出所需的輸入結構的指標。

[out] pvOut

從這個逸出接收輸出之結構的指標。如果沒有傳回任何資料，此參數應該是 Null 。

如果函式成功，則傳回值大於零，但 QUERYESCSUPPORT 印表機逸出除外，這只會檢查實作。如果未實作逸出，則傳回值為零。

如果函式失敗，則傳回值是系統錯誤碼。

注意這是封鎖或同步函式，可能不會立即傳回。此函式傳回的速度取決於執行時間因素，例如網路狀態、列印伺服器組態和印表機驅動程式實作—撰寫應用程式時難以預測的因素。從管理與使用者介面互動的執行緒呼叫此函式，可能會讓應用程式看起來沒有回應。

針對 cbInput 傳遞 0 的效果將取決於 nEscape 的值，以及處理逸出的驅動程式。

在原始印表機逸出中，只能使用下列專案。

逸出	描述
QUERYESCSUPPORT	判斷設備磁碟機是否實作特定的逸出。
PASSTHROUGH	允許應用程式將資料直接傳送至印表機。

如需印表機逸出的相關資訊，請參閱 ExtEscape。

使用 StartPage 函式來準備印表機驅動程式以接收資料。