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	이 작업은 지원되지 않습니다.