DirectDraw 的傳回值

下表列出 DirectDraw 驅動程式提供函式可傳回的值。 DDHAL_DRIVER_Xxx 值實際上是在 DWORD 傳回值中傳回。 DD_OK值和DDERR_Xxx 錯誤碼會傳回至特定函式參數所指向之結構的 ddRVal 成員中。

如需每個函式可以傳回的特定錯誤碼，請參閱參考一節中的函式描述。 如需錯誤碼和傳回值的完整清單，請參閱 DirectDraw 標頭檔 ddraw.h 和 dxmini.h 。 請注意，錯誤碼是以負值表示，而且無法合併。

DirectDraw 驅動程式中的函式必須傳回兩個傳回碼之一：DDHAL_DRIVER_HANDLED或DDHAL_DRIVER_NOTHANDLED。 如果驅動程式傳回DDHAL_DRIVER_HANDLED，則它也必須傳回DD_OK或 ddraw.h中列出的其中一個錯誤碼。 DirectDraw 驅動程式中的函式可以傳回下表中的程式碼。 這些代碼定義于 ddraw.h中。

傳回碼	意義
DD_OK	要求已順利完成。
DDHAL_DRIVER_HANDLED	驅動程式已執行作業，並在傳遞至驅動程式回呼之結構的 ddrval 成員中傳回該作業的有效傳回碼。 如果此程式碼DD_OK，DirectDraw 或 Direct3D 會繼續進行 函式。 否則，DirectDraw 或 Direct3D 會傳回驅動程式所提供的錯誤碼，並中止函式。
DDHAL_DRIVER_NOCKEYHW	顯示驅動程式無法處理呼叫，因為它用盡色彩金鑰硬體資源。
DDHAL_DRIVER_NOTHANDLED	驅動程式對要求的作業沒有批註。 如果需要驅動程式實作特定的回呼，DirectDraw 或 Direct3D 會報告錯誤狀況。 否則，DirectDraw 或 Direct3D 會處理作業，就像執行 DirectDraw 或 Direct3D 裝置無關實作來定義驅動程式回呼一樣。 DirectDraw 和 Direct3D 通常會忽略該回呼參數結構 之 ddrval 成員中傳回的任何值。
DDERR_GENERIC	有未定義的錯誤狀況。
DDERR_OUTOFCAPS	已配置要求作業所需的硬體。
DDERR_UNSUPPORTED	不支援此作業。

在視訊迷你埠驅動程式中實作的DxApi 函式會傳回下表中的其中一個程式碼。 這些代碼定義于 dxmini.h中。

傳回碼	意義
DX_OK	要求已順利完成。
DXERR_GENERIC	有未定義的錯誤狀況。
DXERR_OUTOFCAPS	已配置要求作業所需的硬體。
DXERR_UNSUPPORTED	不支援此作業。