функция обратного вызова DXGKCB_PINFRAMEBUFFERFORSAVE2 (d3dkmddi.h)

  • Статья

Драйвер минипорта в режиме ядра вызывает DXGKCB_PINFRAMEBUFFERFORSAVE2 для одновременного закрепления всего буфера кадров.

Синтаксис

DXGKCB_PINFRAMEBUFFERFORSAVE2 DxgkcbPinframebufferforsave2;

NTSTATUS DxgkcbPinframebufferforsave2(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARGCB_PINFRAMEBUFFERFORSAVE2 pPinFrameBufferForSave2
)
{...}

Параметры

[in] hAdapter

Дескриптор видеоадаптера. Драйвер предоставляет этот дескриптор для устройства main/свинца в цепочке связанного видеоадаптера (LDA).

[in/out] pPinFrameBufferForSave2

Указатель на DXGKARGCB_PINFRAMEBUFFERFORSAVE2 структуру, содержащую сведения о буфере кадров для сохранения.

Возвращаемое значение

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

Комментарии

Исходная реализация WDDM 2.4 IOMMU включала пару функций обратного вызова для запроса памяти, необходимой для сохранения буфера кадров. Область сохранения буфера кадров была создана в качестве объекта раздела во время инициализации, и драйвер использовал эти обратные вызовы для получения сопоставленной области IOMMU при необходимости.

Драйверы, использующие списки дескрипторов адресов (ADL) для поддержки логического переназначения 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

DXGKARGCB_PINFRAMEBUFFERFORSAVE

DXGKCB_UNPINFRAMEBUFFERFORSAVE