DXGKCB_PINFRAMEBUFFERFORSAVE2 fonction de rappel (d3dkmddi.h)
Un pilote 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 vers un adaptateur d’affichage. Le pilote fournit ce handle pour le périphérique principal/prospect 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 d’images à enregistrer.
Valeur de retour
DXGKCB_PINFRAMEBUFFERFORSAVE2 retourne STATUS_SUCCESS si l’opération réussit. Sinon, retourne un code d’erreur NTSTATUS approprié.
Remarques
L’implémentation WDDM 2.4 IOMMU comprenait une paire de fonctions de rappel pour interroger la mémoire nécessaire pour enregistrer la mémoire tampon d’images. La zone d’enregistrement de 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 par l’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écouplée à l’aide du rappel de DXGKCB_UNPINFRAMEBUFFERFORSAVE d’origine.
Pour plus d’informations, consultez de remapping 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.
Exigences
| Exigence | Valeur |
|---|---|
| serveur minimum pris en charge | Windows Server 2022 (WDDM 2.9) |
| d’en-tête | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |
Voir aussi
DXGKARGCB_PINFRAMEBUFFERFORSAVE2