функция обратного вызова DXGKCB_INVALIDATEHWCONTEXT (d3dkmddi.h)
Графический драйвер в режиме ядра (KMD) вызывает DxgkcbInvalidatehwcontext для недопустимого контекста оборудования.
Синтаксис
DXGKCB_INVALIDATEHWCONTEXT DxgkcbInvalidatehwcontext;
NTSTATUS DxgkcbInvalidatehwcontext(
[in] IN_CONST_PDXGKARGCB_INVALIDATEHWCONTEXT unnamedParam1
)
{...}
Параметры
[in] unnamedParam1
Указатель на структуру DXGKARGCB_INVALIDATEHWCONTEXT, содержащую сведения для Dxgkrnl, чтобы использовать для отмены контекста оборудования.
Возвращаемое значение
DxgkcbInvalidatehwcontext возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае возвращается соответствующий код ошибки NTSTATUS.
Замечания
Вызовы KMD DxgkcbInvalidatehwcontext, чтобы уведомить систему о том, когда состояние и ресурсы, связанные с аппаратным контекстом, больше не являются допустимыми или согласованными, поэтому необходимо сбросить или повторно инициализировать контекст, прежде чем его можно будет использовать снова. Контекст должен быть недопустим в случае операции сброса аппаратного модуля, которая может быть вызвана различными причинами, например восстановлением из-за сбоя или перенастройки ресурсов GPU.
Dxgkrnl помечает контекст как недопустимый, чтобы он больше не планировался для выполнения на GPU. Затем он инициирует любую необходимую очистку, например освобождение ресурсов, связанных с контекстом или сброс любого состояния, связанного с контекстом.
DXGKCB_XXX функции реализуются Dxgkrnl. Чтобы использовать эту функцию обратного вызова, задайте элементы DXGKARGCB_INVALIDATEHWCONTEXT, а затем вызовите DxgkCbInvalidateHwContext через DXGKRNL_INTERFACE.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 10 версии 1703 (WDDM 2.2) |
| заголовка | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |