PFND3D10DDI_CREATERASTERIZERSTATE回呼函式 (d3d10umddi.h)

  • 發行項

CreateRasterizerState 函式會建立點陣化狀態。

語法

PFND3D10DDI_CREATERASTERIZERSTATE Pfnd3d10ddiCreaterasterizerstate;

void Pfnd3d10ddiCreaterasterizerstate(
  D3D10DDI_HDEVICE unnamedParam1,
  const D3D10_DDI_RASTERIZER_DESC *unnamedParam2,
  D3D10DDI_HRASTERIZERSTATE unnamedParam3,
  D3D10DDI_HRTRASTERIZERSTATE unnamedParam4
)
{...}

參數

unnamedParam1

hDevice [in]

顯示裝置的句柄 (圖形內容) 。

unnamedParam2

pRasterizerDesc [in]

D3D10_DDI_RASTERIZER_DESC結構的指標，描述使用者模式顯示驅動程式用來建立點陣化狀態的參數。

unnamedParam3

hRasterizerState [in]

驅動程式私人數據的句柄，用於點陣化狀態。 驅動程式會傳回 Microsoft Direct3D 執行時間必須從呼叫驅動程式 的 CalcPrivateRasterizerStateSize 函式配置私人數據的大小，以位元組為單位。 句柄實際上只是記憶體區域的指標，也就是驅動程式要求的大小。 驅動程式會使用此記憶體區域來儲存與其點陣化狀態對象相關的內部數據結構。

unnamedParam4

hRTRasterizerState [in]

驅動程式在回呼 Direct3D 運行時間時應該使用點陣化狀態的句柄。

傳回值

無

備註

驅動程式可以使用 pfnSetErrorCb 回呼函式來設定錯誤碼。

如果驅動程式用盡記憶體) 或D3DDDIERR_DEVICEREMOVED (装置已在 pfnSetErrorCb 函式呼叫中移除) ，則驅動程式可以傳遞E_OUTOFMEMORY (。 Direct3D 運行時間會判斷任何其他錯誤都很重要。 如果驅動程式通過任何錯誤，包括D3DDDIERR_DEVICEREMOVED，Direct3D 運行時間會判斷句柄無效;因此，運行時間不會呼叫 DestroyRasterizerState 函式來終結 hRasterizerState 參數所指定的句柄。

使用者模式顯示驅動程式不需要一次在裝置上建立超過 4,096 個點陣化狀態物件的唯一實例。

規格需求

需求 值
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
目標平台 桌面
標頭 d3d10umddi.h (include D3d10umddi.h)

另請參閱

CalcPrivateRasterizerStateSize

D3D10DDI_DEVICEFUNCS

D3D10_DDI_RASTERIZER_DESC

DestroyRasterizerState

pfnSetErrorCb