NtGdiDdSetOverlayPosition 函式

[此函式可能會隨著每個作業系統修訂而變更。 請改用 Microsoft DirectDraw 和 Microsoft Direct3DAPIs;這些 API 會隔離應用程式與這類作業系統變更,並隱藏與顯示驅動程式直接互動所涉及的許多其他困難。

設定重迭的位置。

語法

DWORD APIENTRY NtGdiDdSetOverlayPosition(
  _In_    HANDLE                     hSurfaceSource,
  _In_    HANDLE                     hSurfaceDestination,
  _Inout_ PDD_SETOVERLAYPOSITIONDATA puSetOverlayPositionData
);

參數

hSurfaceSource [in]

代表 DirectDraw 重迭介面 的DD_SURFACE_LOCAL 結構控制碼。

hSurfaceDestination [in]

DD_SURFACE_LOCAL結構的指標,表示要重載的介面。

puSetOverlayPositionData [in, out]

DD_SETOVERLAYPOSITIONDATA結構的指標,其中包含設定重迭位置所需的資訊。

傳回值

NtGdiDdSetOverlayPosition 會傳回下列其中一個回呼程式碼。

傳回碼 描述
DDHAL_DRIVER_HANDLED
驅動程式已執行作業,並傳回該作業的有效傳回碼。 如果此程式碼DD_OK,DirectDraw 或 Direct3D 會繼續進行 函式。 否則,DirectDraw 或 Direct3D 會傳回驅動程式所提供的錯誤碼,並中止函式。
DDHAL_DRIVER_NOTHANDLED
驅動程式對於要求的作業沒有批註。 如果需要驅動程式實作特定的回呼,DirectDraw 或 Direct3D 會報告錯誤狀況。 否則,DirectDraw 或 Direct3D 會處理作業,就像驅動程式回呼尚未藉由執行 DirectDraw 或 Direct3D 裝置獨立實作來定義。

 

規格需求

需求
最低支援的用戶端
Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器
Windows 2000 Server [僅限桌面應用程式]
標頭
Ntgdi.h

另請參閱

圖形低階用戶端支援