Compartilhar via


Retornando códigos de erro recebidos de funções de runtime

As chamadas para as funções fornecidas pelo driver de exibição do modo de usuário do Direct3D versão 9 devem retornar códigos de erro que recebem quando chamam as funções de acesso de kernel-services fornecidas pelo runtime do Direct3D. Por exemplo, o runtime pode chamar uma função de driver de exibição no modo de usuário, como a função CreateResource . Isso, por sua vez, chama uma função fornecida por runtime, como a função pfnAllocateCb , para executar uma operação específica, nesse caso, para alocar memória para o recurso. Se o driver de exibição do modo de usuário receber um código de erro da chamada para a função fornecida pelo runtime, ele deverá retornar esse código de erro de volta ao runtime.

Há uma exceção à regra de que um driver deve passar um código de erro de runtime de volta para o runtime. Quando o driver chama a função fornecida por runtime pfnAllocateCb , para alocar memória de vídeo para recursos opcionais quando a memória de vídeo já está alocada, a regra não se aplica. Se pfnAllocateCb não alocar essa memória de vídeo para recursos opcionais necessários apenas para otimizar o desempenho, o driver não deverá relatar o erro de memória insuficiente (E_OUTOFMEMORY) de volta ao runtime.