Valores retornados para DirectDraw

As tabelas a seguir listam valores que podem ser retornados pelas funções fornecidas pelo driver DirectDraw. Os valores DDHAL_DRIVER_Xxx realmente são retornados no valor de retorno DWORD. Os códigos de erro DD_OK e DDERR_Xxx são retornados no membro ddRVal da estrutura para a qual o parâmetro da função específica aponta.

Para obter códigos de erro específicos que cada função pode retornar, consulte as descrições de função na seção de referência. Consulte Arquivos de cabeçalho do DirectDraw ddraw.h e dxmini.h para obter uma listagem completa de códigos de erro e valores retornados. Observe que os códigos de erro são representados por valores negativos e não podem ser combinados.

Uma função em um driver DirectDraw deve retornar um dos dois códigos de retorno: DDHAL_DRIVER_HANDLED ou DDHAL_DRIVER_NOTHANDLED. Se o driver retornar DDHAL_DRIVER_HANDLED, ele também deverá retornar DD_OK ou um dos códigos de erro listados em ddraw.h. Uma função em um driver DirectDraw pode retornar os códigos na tabela a seguir. Esses códigos são definidos em ddraw.h.

Código de retorno	Significado
DD_OK	A solicitação foi concluída com êxito.
DDHAL_DRIVER_HANDLED	O driver executou a operação e retornou um código de retorno válido para essa operação no membro ddrval da estrutura passada para o retorno de chamada do driver. Se esse código for DD_OK, DirectDraw ou Direct3D prosseguirá com a função . Caso contrário, DirectDraw ou Direct3D retornará o código de erro fornecido pelo driver e anulará a função.
DDHAL_DRIVER_NOCKEYHW	O driver de exibição não pôde lidar com a chamada porque ela ficou sem recursos de hardware de chave de cor.
DDHAL_DRIVER_NOTHANDLED	O driver não tem comentários sobre a operação solicitada. Se o driver for necessário para ter implementado um retorno de chamada específico, DirectDraw ou Direct3D relatará uma condição de erro. Caso contrário, DirectDraw ou Direct3D manipula a operação como se o retorno de chamada do driver não tivesse sido definido executando a implementação independente do dispositivo DirectDraw ou Direct3D. DirectDraw e Direct3D normalmente ignoram qualquer valor retornado no membro ddrval da estrutura de parâmetros desse retorno de chamada.
DDERR_GENERIC	Há uma condição de erro indefinida.
DDERR_OUTOFCAPS	O hardware necessário para a operação solicitada já foi alocado.
DDERR_UNSUPPORTED	A operação não tem suporte.

Uma função DxApi implementada em um driver de miniporto de vídeo retorna um dos códigos na tabela a seguir. Esses códigos são definidos em dxmini.h.

Código de retorno	Significado
DX_OK	A solicitação foi concluída com êxito.
DXERR_GENERIC	Há uma condição de erro indefinida.
DXERR_OUTOFCAPS	O hardware necessário para a operação solicitada já foi alocado.
DXERR_UNSUPPORTED	A operação não tem suporte.