функция обратного вызова DXGKCB_PINFRAMEBUFFERFORSAVE2 (d3dkmddi.h)
В режиме ядра драйвер мини-порта вызывает DXGKCB_PINFRAMEBUFFERFORSAVE2, чтобы закрепить весь буфер кадра одновременно.
Синтаксис
DXGKCB_PINFRAMEBUFFERFORSAVE2 DxgkcbPinframebufferforsave2;
NTSTATUS DxgkcbPinframebufferforsave2(
[in] IN_CONST_HANDLE hAdapter,
[in/out] INOUT_PDXGKARGCB_PINFRAMEBUFFERFORSAVE2 pPinFrameBufferForSave2
)
{...}
Параметры
[in] hAdapter
Дескриптор адаптера отображения. Драйвер предоставляет этот дескриптор для основного или ведущего устройства в цепочке связанного адаптера отображения (LDA).
[in/out] pPinFrameBufferForSave2
Указатель на структуру DXGKARGCB_PINFRAMEBUFFERFORSAVE2, содержащую сведения о буфере кадра для сохранения.
Возвращаемое значение
DXGKCB_PINFRAMEBUFFERFORSAVE2 возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае возвращает соответствующий код ошибки NTSTATUS.
Замечания
Исходная реализация WDDM 2.4 IOMMU включала пару функций обратного вызова для запроса памяти, необходимой для сохранения буфера кадров. Буфер кадра был создан в качестве объекта раздела во время инициализации, и драйвер использовал эти обратные вызовы для получения сопоставленной области IOMMU при необходимости.
Драйверы, использующие списки дескрипторов адресов (ADLs) для поддержки логического перемечения DMA, реализуют DXGKCB_PINFRAMEBUFFERFORSAVE2 вместо DXGKARGCB_PINFRAMEBUFFERFORSAVE.
Память, закрепленная с помощью DXGKCB_PINFRAMEBUFFERFORSAVE2, может быть откречена с помощью исходного обратного вызова DXGKCB_UNPINFRAMEBUFFERFORSAVE.
Дополнительные сведения см. в переназначивания DMA IOMMU.
DXGKCB_XXX функции реализуются Dxgkrnl. Чтобы использовать эту функцию обратного вызова, задайте соответствующие члены DXGKARGCB_PINFRAMEBUFFERFORSAVE2, а затем вызовите DxgkCbPinFrameBufferForSave2 через DXGKRNL_INTERFACE.
Требования
| Требование | Ценность |
|---|---|
| минимальный поддерживаемый сервер | Windows Server 2022 (WDDM 2.9) |
| заголовка | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |
См. также
DXGKARGCB_PINFRAMEBUFFERFORSAVE2