PFND3D11DDI_CHECKDEFERREDCONTEXTHANDLESIZES回呼函式 (d3d10umddi.h)

發行項
02/22/2024

CheckDeferredContextHandleSizes 函式會驗證驅動程式私人記憶體空間的大小，以保存延遲內容句柄的句柄數據。

語法

PFND3D11DDI_CHECKDEFERREDCONTEXTHANDLESIZES Pfnd3d11ddiCheckdeferredcontexthandlesizes;

void Pfnd3d11ddiCheckdeferredcontexthandlesizes(
  D3D10DDI_HDEVICE unnamedParam1,
  UINT *pHSizes,
  D3D11DDI_HANDLESIZE *unnamedParam3
)
{...}

參數

unnamedParam1

hDevice [in]

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

pHSizes

pHandleSize 所指向數位的大小，以位元組為單位。

unnamedParam3

pHandleSize [out，選擇性]

描述延遲內容句柄之句柄數據的 D3D11DDI_HANDLESIZE 結構數位。

傳回值

無

備註

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

只有在驅動程式支援可從呼叫 GetCaps (D3D10_2) 函式的 D3D11DDI_THREADING_CAPS 結構中傳回的D3D11DDICAPS_COMMANDLISTS_BUILD_2功能時，才需要驅動程序實作 CheckDeferredContextHandleSizes。

如需如何使用 CheckDeferredContextHandleSizes 的詳細資訊，請參閱使用 Context-Local DDI 句柄。

驅動程式的 CheckDeferredContextHandleSizes 函式無法呼叫 pfnSetErrorCb 回呼函式來設定 D3DDDIERR_DEVICEREMOVED 錯誤碼，因為 CheckDeferredContextHandleSizes 是函式的功能檢查類型。驅動程式必須在裝置建立之後，確保它有足夠的資訊，才能回應 CheckDeferredContextHandleSizes 的呼叫，即使存在 D3DDDIERR_DEVICEREMOVED也是如此。

CheckDeferredContextHandleSizes 不應該發生任何錯誤。不過， CheckDeferredContextHandleSizes 可能會針對重大錯誤呼叫 pfnSetErrorCb 。

規格需求

需求	值
最低支援的用戶端	從 Windows 7 操作系統開始，支援 CheckDeferredContextHandleSizes。
目標平台	桌面
標頭	d3d10umddi.h (包含 D3d10umddi.h)