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 identificador para el dispositivo principal/cliente potencial en la cadena del adaptador de pantalla vinculado (LDA).
[in/out] pPinFrameBufferForSave2
Puntero a una estructura de 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.
Observaciones
La implementación original de WDDM 2.4 IOMMU 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 de DXGKCB_UNPINFRAMEBUFFERFORSAVE original.
Consulte de reasignación de IOMMU DMA 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 llame a DxgkCbPinFrameBufferForSave2 a través del DXGKRNL_INTERFACE.
Requisitos
| Requisito | Valor |
|---|---|
| servidor mínimo admitido | Windows Server 2022 (WDDM 2.9) |
| encabezado de | d3dkmddi.h |
| irQL | PASSIVE_LEVEL |
Consulte también
DXGKARGCB_PINFRAMEBUFFERFORSAVE2