NtGdiDdCreateD3DBuffer 函式

  • 發行項

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

用來建立指定描述的驅動程式層級命令或頂點緩衝區。

語法

DWORD APIENTRY NtGdiDdCreateD3DBuffer(
  _In_    HANDLE               hDirectDraw,
  _Inout_ HANDLE               *hSurface,
  _Inout_ DDSURFACEDESC        *puSurfaceDescription,
  _Inout_ DD_SURFACE_GLOBAL    *puSurfaceGlobalData,
  _Inout_ DD_SURFACE_LOCAL     *puSurfaceLocalData,
  _Inout_ DD_SURFACE_MORE      *puSurfaceMoreData,
  _Inout_ DD_CREATESURFACEDATA *puCreateSurfaceData,
  _Inout_ HANDLE               *puhSurface
);

參數

hDirectDraw [in]

代表驅動程式 之DD_DIRECTDRAW_GLOBAL 結構的控制碼。

hSurface [in， out]

介面控點陣列的指標。 如果介面在模式切換之後重新建立，呼叫端可以將這些控制碼設定為先前的控制碼值。 此程式在 DirectDraw 檔中稱為「還原」。

puSurfaceDescription [in， out]

DDSURFACEDESC結構的指標，描述驅動程式應該建立的介面或緩衝區。

puSurfaceGlobalData [in， out]

DD_SURFACE_GLOBAL結構的指標，其中包含與多個表面全域共用的介面資料。

puSurfaceLocalData [in， out]

描述驅動程式所建立介面物件的 DD_SURFACE_LOCAL 結構的指標。 此陣列中通常只有一個專案。

puSurfaceMoreData [in， out]

包含其他本機表面資料的 DD_SURFACE_MORE 結構的指標。

puCreateSurfaceData [in， out]

DD_CREATESURFACEDATA結構的指標，其中包含建立緩衝區所需的資訊。

puhSurface [in， out]

由 DirectDraw API 使用，不應由驅動程式填入。

傳回值

NtGdiDdCreateD3DBuffer 會傳回下列其中一個回呼代碼。

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

 

規格需求

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

另請參閱

圖形低階用戶端支援