分享方式：

PFND3D11_1DDI_ASSIGNDEBUGBINARY回呼函式 （d3d10umddi.h）

提供著色器建立之後可用的完整著色器二進位檔。 完整的著色器二進位檔可讓驅動程式擷取偵錯資訊或其他無法供驅動程式使用的著色器二進位資訊。

語法

PFND3D11_1DDI_ASSIGNDEBUGBINARY Pfnd3d111DdiAssigndebugbinary;

void Pfnd3d111DdiAssigndebugbinary(
       D3D10DDI_HDEVICE unnamedParam1,
       D3D10DDI_HSHADER unnamedParam2,
       UINT uBinarySize,
  [in] const VOID *pBinary
)
{...}

參數

unnamedParam1

hDevice [in]

顯示裝置的句柄（圖形內容）。

unnamedParam2

hShader [in]

著色器對象的驅動程式私用數據的句柄。

uBinarySize

完整著色器二進位檔的大小，以位元組為單位。

[in] pBinary

完整著色器二進位檔的指標。

傳回值

沒有

言論

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

只有在下列所有專案都成立時，才會呼叫 assignDebugBinary ：

  • 裝置可以進行偵錯。
  • 使用者模式顯示驅動程式已設定 D3D11_1DDI_D3D11_OPTIONS_DATA。AssignDebugBinarySupport 旗標 TRUE。
  • 已呼叫 CreateXxxShaderXxx 著色器建立函式、成功，並傳回著色器的句柄。
除了 D3DDDIERR_DEVICEREMOVED之外，驅動程式不應該發生任何錯誤。 因此，如果驅動程式傳遞任何錯誤，除了 D3DDDIERR_DEVICEREMOVED之外，在呼叫 pfnSetErrorCb 函式時，Microsoft Direct3D 運行時間會判斷錯誤很重要。 即使移除裝置，驅動程式也不需要傳回 D3DDDIERR_DEVICEREMOVED;不過，如果裝置移除干擾了 AssignDebugBinary 的作業（通常不應該發生），驅動程式可以傳回 D3DDDIERR_DEVICEREMOVED。

要求

要求 價值
最低支援的用戶端 Windows 8
支援的最低伺服器 Windows Server 2012
目標平臺 桌面
標頭 d3d10umddi.h （包括 D3d10umddi.h）

另請參閱

D3D11_1DDI_D3D11_OPTIONS_DATA

pfnSetErrorCb