DXGKCB_PINFRAMEBUFFERFORSAVE2 fonction de rappel (d3dkmddi.h)

  • Article

Un pilote d’affichage miniport en mode noyau appelle DXGKCB_PINFRAMEBUFFERFORSAVE2 pour épingler une mémoire tampon d’image entière à la fois.

Syntaxe

DXGKCB_PINFRAMEBUFFERFORSAVE2 DxgkcbPinframebufferforsave2;

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

Paramètres

[in] hAdapter

Handle d’une carte d’affichage. Le pilote fournit ce handle pour le périphérique main/principal dans la chaîne de l’adaptateur d’affichage lié (LDA).

[in/out] pPinFrameBufferForSave2

Pointeur vers une structure DXGKARGCB_PINFRAMEBUFFERFORSAVE2 qui contient des informations sur la mémoire tampon de trame à enregistrer.

Valeur retournée

DXGKCB_PINFRAMEBUFFERFORSAVE2 retourne STATUS_SUCCESS si l’opération réussit. Sinon, retourne un code d’erreur NTSTATUS approprié.

Remarques

L’implémentation IOMMU WDDM 2.4 d’origine comprenait une paire de fonctions de rappel pour interroger la mémoire nécessaire pour enregistrer la mémoire tampon de trame. La zone d’enregistrement de la mémoire tampon de trame a été créée en tant qu’objet de section lors de l’initialisation, et le pilote a utilisé ces rappels pour obtenir une région mappée IOMMU si nécessaire.

Les pilotes qui utilisent des listes de descripteurs d’adresses (ADL) pour prendre en charge le remapping DMA logique implémentent DXGKCB_PINFRAMEBUFFERFORSAVE2 au lieu de DXGKARGCB_PINFRAMEBUFFERFORSAVE.

La mémoire épinglée à l’aide de DXGKCB_PINFRAMEBUFFERFORSAVE2 peut être désinpinée à l’aide du rappel DXGKCB_UNPINFRAMEBUFFERFORSAVE d’origine .

Pour plus d’informations, consultez La remappage iommu DMA .

DXGKCB_XXX fonctions sont implémentées par Dxgkrnl. Pour utiliser cette fonction de rappel, définissez les membres appropriés de DXGKARGCB_PINFRAMEBUFFERFORSAVE2 , puis appelez DxgkCbPinFrameBufferForSave2 via le DXGKRNL_INTERFACE.

Configuration requise

Condition requise Valeur
Serveur minimal pris en charge Windows Server 2022 (WDDM 2.9)
En-tête d3dkmddi.h
IRQL PASSIVE_LEVEL

Voir aussi

DXGKARGCB_PINFRAMEBUFFERFORSAVE2

DXGKARGCB_PINFRAMEBUFFERFORSAVE

DXGKCB_UNPINFRAMEBUFFERFORSAVE