Обработка ошибок

Функции Direct3D версии 10, реализующие драйвер отображения пользовательского режима, обычно имеют VOID для типа возвращаемого параметра. Основным исключением этого правила является функция CalcPrivateObjTypeSize-type (например, функция CalcPrivateResourceSize ). Этот тип функции возвращает тип параметра SIZE_T, указывающий размер области памяти, которую требует драйвер для создания конкретного типа объекта с помощью функции CreateObjType-type (например, CreateResource(D3D10)).

Возвращая VOID, драйвер отображения в пользовательском режиме не уведомляет среду выполнения Direct3D об ошибках обычным способом (то есть с помощью параметра возврата функции драйвера в пользовательском режиме). Вместо этого драйвер отображения в пользовательском режиме должен использовать функцию обратного вызова pfnSetErrorCb среды выполнения Direct3D для передачи такой информации обратно в среду выполнения. Среда выполнения предоставляет указатель на свой pfnSetErrorCb в структуре D3D10DDI_CORELAYER_DEVICECALLBACKS, на которую элемент pUMCallbacks структуры D3D10DDIARG_CREATEDEVICE указывает при вызове функции CreateDevice(D3D10).

Страница со справочной информацией для каждой функции дисплейного драйвера в пользовательском режиме указывает ошибки, о которых функция может сообщать через вызов pfnSetErrorCb. Это означает, что если драйвер отображения в пользовательском режиме вызывает pfnSetErrorCb с кодом ошибки, который не разрешен для текущей функции драйвера в пользовательском режиме, среда выполнения определяет, что условие ошибки является критически важным и действует соответствующим образом. Так как среда выполнения будет действовать соответствующим образом во время pfnSetErrorCb, вы не должны ожидать, что вы можете отменить эффекты вызова pfnSetErrorCb(E_FAIL), вызвав что-то подобное pfnSetErrorCb( S_OK). На самом деле среда выполнения определяет, что S_OK так же критично или недопустимо, как и E_FAIL. Концепция кода возврата S_OK эквивалентна функции драйвера отображения в пользовательском режиме, не вызывая pfnSetErrorCb вообще.

Если runtime Direct3D определяет, что условие ошибки критическое, сначала предпримет действие, записав ошибку через Dr. Watson, который является отладчиком по умолчанию после сбоя (just-in-time). Затем среда выполнения умышленно отключит устройство, чтобы сымитировать сценарий ошибки, связанный с получением кода D3DDDIERR_DEVICEREMOVED. Если потребуется, чтобы драйвер вызывал функцию обратного вызова pfnSetErrorCb, вероятность того, что с каждой ошибкой, возникающей в драйвере, будет ассоциирован полезный стек вызовов, значительно возрастает. Наличие стека вызовов, связанного с ошибкой, позволяет быстро провести диагностику и сгенерировать точные логи Dr. Watson.

В коде драйвера следует использовать pfnSetErrorCb , если в драйвере происходит ошибка, даже если возвращается код ошибки, который среда выполнения не допускает для конкретной функции драйвера, определяется средой выполнения как ошибка драйвера или проблема. Было бы еще хуже, если бы драйвер отображения в пользовательском режиме поглощал критические ошибки и продолжал работу. Драйвер отображения в пользовательском режиме должен вызывать pfnSetErrorCb как можно ближе к точке обнаружения ошибок, чтобы предоставить полезный стек вызовов для посмертной отладки.

В следующей таблице перечислены категории ошибок, которые исполняемая среда Direct3D допускает из определенных функций драйвера.