NtGdiDdCreateSurfaceObject 函式

  • 發行項

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

建立核心模式介面物件，代表 puSurfaceLocal所參考的使用者模式介面物件。

語法

HANDLE APIENTRY NtGdiDdCreateSurfaceObject(
  _In_ HANDLE             hDirectDrawLocal,
  _In_ HANDLE             hSurface,
  _In_ PDD_SURFACE_LOCAL  puSurfaceLocal,
  _In_ PDD_SURFACE_MORE   puSurfaceMore,
  _In_ PDD_SURFACE_GLOBAL puSurfaceGlobal,
  _In_ BOOL               bComplete
);

參數

hDirectDrawLocal [in]

核心模式 DirectDraw 物件的控制碼。

hSurface [in]

相同表面的上一個控制碼。 如果在模式切換之後重新建立表面，則會使用 。

puSurfaceLocal [in]

DD_SURFACE_LOCAL結構的指標，代表要與配置記憶體產生關聯的 DirectDraw 使用者模式介面物件。 如需詳細資訊，請參閱 DDK 檔。

puSurfaceMore [in]

DD_SURFACE_MORE結構的指標，其中包含每個個別介面物件的其他本機資料。 如需詳細資訊，請參閱 DDK 檔。

puSurfaceGlobal [in]

DD_SURFACE_GLOBAL結構的指標，其中包含與多個表面全域共用的介面資料。 如需詳細資訊，請參閱 DDK 檔。

bComplete [in]

核心模式物件完成旗標。 可以是下列其中一個值。

(TRUE)

完成有關核心模式標記法的所有處理。

(FALSE)

建立 物件，但不設定內部資料，例如記憶體指標。 使用 FALSE 建立的物件可以使用 NtGdiDdAttachSurface 附加，並透過 呼叫 NtGdiDdCreateSurface來完成。

傳回值

如果成功，此函式會傳回核心模式介面標記法的控制碼;否則會傳回 Null。

備註

建議您使用 DirectDraw 和 Direct3D API 來建立和管理圖形裝置物件。 這些建構會以簡化且與作業系統無關的方式抽象化裝置建立程式。

規格需求

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

另請參閱

圖形低階用戶端支援

DdCreateSurfaceObject

NtGdiDdDeleteSurfaceObject

NtGdiDdAttachSurface

NtGdiDdCreateSurface