DXGKCB_PINFRAMEBUFFERFORSAVE2 función de devolución de llamada (d3dkmddi.h)

Un controlador de miniporte de pantalla en modo kernel llama a DXGKCB_PINFRAMEBUFFERFORSAVE2 para anclar un búfer de fotogramas completo a la vez.

Sintaxis

DXGKCB_PINFRAMEBUFFERFORSAVE2 DxgkcbPinframebufferforsave2;

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

Parámetros

[in] hAdapter

Identificador de un adaptador de pantalla. El controlador proporciona este controlador para el dispositivo principal/cliente potencial en la cadena del adaptador de pantalla vinculado (LDA).

[in/out] pPinFrameBufferForSave2

Puntero a una estructura DXGKARGCB_PINFRAMEBUFFERFORSAVE2 que contiene información sobre el búfer de fotogramas que se va a guardar.

Valor devuelto

DXGKCB_PINFRAMEBUFFERFORSAVE2 devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, devuelve un código de error NTSTATUS adecuado.

Comentarios

La implementación original de IOMMU de WDDM 2.4 incluía un par de funciones de devolución de llamada para consultar la memoria necesaria para guardar el búfer de fotogramas. El área de guardado del búfer de fotogramas se creó como un objeto de sección durante la inicialización y el controlador usó estas devoluciones de llamada para obtener una región asignada por IOMMU cuando sea necesario.

Los controladores que usan listas de descriptores de direcciones (ADL) para admitir la reasignación lógica de DMA implementan DXGKCB_PINFRAMEBUFFERFORSAVE2 en lugar de DXGKARGCB_PINFRAMEBUFFERFORSAVE.

La memoria anclada mediante DXGKCB_PINFRAMEBUFFERFORSAVE2 se puede desanclar mediante la devolución de llamada DXGKCB_UNPINFRAMEBUFFERFORSAVE original.

Consulte la reasignación de DMA de IOMMU para obtener más información.

DXGKCB_XXX funciones se implementan mediante Dxgkrnl. Para usar esta función de devolución de llamada, establezca los miembros adecuados de DXGKARGCB_PINFRAMEBUFFERFORSAVE2 y, a continuación, llame a DxgkCbPinFrameBufferForSave2 a través del DXGKRNL_INTERFACE.

Requisitos

Consulte también

DXGKARGCB_PINFRAMEBUFFERFORSAVE2

DXGKARGCB_PINFRAMEBUFFERFORSAVE

DXGKCB_UNPINFRAMEBUFFERFORSAVE