функция обратного вызова DXGKDDI_RELEASESWIZZLINGRANGE (d3dkmddi.h)
Функция DxgkDdiReleaseSwizzlingRange освобождает диапазон свертывания, который ранее настроена функция DxgkDdiAcquireSwizzlingRange.
Синтаксис
DXGKDDI_RELEASESWIZZLINGRANGE DxgkddiReleaseswizzlingrange;
NTSTATUS DxgkddiReleaseswizzlingrange(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_RELEASESWIZZLINGRANGE pReleaseSwizzlingRange
)
{...}
Параметры
[in] hAdapter
Дескриптор к блоку контекста, связанному с адаптером отображения. Драйвер минипорта отображения ранее предоставил этот дескриптор подсистеме ядра графики Microsoft DirectX в MiniportDeviceContext выходном параметре функции DxgkDdiAddDevice.
[in] pReleaseSwizzlingRange
Указатель на структуру DXGKARG_RELEASESWIZZLINGRANGE, содержащую сведения о освобождении диапазона свертывания.
Возвращаемое значение
DxgkDdiReleaseSwizzlingRange возвращает STATUS_SUCCESS или соответствующий результат ошибки, если диапазон сверток не выпущен.
Замечания
Функция DxgkDdiReleaseSwizzlingRange обычно вызывается при указанном выделении (т. е. элемент hAllocation структуры DXGKARG_RELEASESWIZZLINGRANGE, на которую указывает параметр pReleaseSwizzlingRange) или если для другого выделения требуется вихрительный диапазон, который указывает элемент RangeId элемента DXGKARG_RELEASESWIZZLINGRANGE.
Если указанное выделение в настоящее время связано с несколькими диапазонами поворота (посредством вызовов функции DxgkDdiAcquireSwizzlingRange), драйвер мини-порта отображения должен освободить только диапазон свертывания, который RangeId член DXGKARG_RELEASESWIZZLINGRANGE. Если драйвер минипорта отображения освобождает все диапазоны свертывания, связанные с выделением, случайное повреждение в выделении может привести к тому, что приложение в настоящее время может использовать один или несколько диапазонов ветвращения.
Драйвер должен использовать сопоставленный с памятью ввод-вывод (MMIO) для настройки диапазона вибрирования. Эти поворотные диапазоны доступа не должны препятствовать выполнению GPU (т. е. gpu не должно быть бездействующим при вызове DxgkDdiReleaseSwizzlingRange).
Все вызовы DxgkDdiReleaseSwizzlingRange сериализуются между собой, но не с другими функциями интерфейса драйвера устройства (DDI).
DxgkDdiReleaseSwizzlingRange должен быть доступен для страницы.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows Vista |
| целевая платформа | Настольный |
| заголовка | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |