NtGdiD3DrawPrimitives2 函式

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

呈現基本類型，並傳回更新的轉譯狀態。

語法

DWORD APIENTRY NtGdiD3DDrawPrimitives2(
  _In_    HANDLE                         hCmdBuf,
  _In_    HANDLE                         hVBuf,
  _Inout_ LPD3DNTHAL_DRAWPRIMITIVES2DATA pded,
  _Inout_ FLATPTR                        *pfpVidMemCmd,
  _Inout_ DWORD                          *pdwSizeCmd,
  _Inout_ FLATPTR                        *pfpVidMemVtx,
  _Inout_ DWORD                          *pdwSizeVtx
);

參數

hCmdBuf [in]

可識別包含命令資料的 DirectDraw 表面 之DD_SURFACE_LOCAL 結構的控制碼。

hVBuf [in]

可識別包含頂點資料的 DirectDraw 表面之 DD_SURFACE_LOCAL 結構的控制碼。

pded [in， out]

D3DNTHAL_DRAWPRIMITIVES2DATA結構的指標，其中包含驅動程式轉譯一或多個基本類型所需的資訊。

pfpVidMemCmd [in， out]

如果驅動程式交換命令緩衝區，則為視訊記憶體的新指標。

pdwSizeCmd [in， out]

指定驅動程式必須增加交換命令緩衝區的最小位元組數目。

pfpVidMemVtx [in， out]

如果驅動程式交換頂點緩衝區，則為視訊記憶體的新指標。

pdwSizeVtx [in， out]

指定驅動程式必須配置給交換頂點緩衝區的最小位元組數目。

傳回值

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

傳回碼	描述
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

另請參閱

圖形低階用戶端支援