DXGKCB_PINFRAMEBUFFERFORSAVE2 Rückruffunktion (d3dkmddi.h)

Artikel
02/23/2024

Ein Kernelmodusanzeige-Miniporttreiber ruft DXGKCB_PINFRAMEBUFFERFORSAVE2 auf, um einen gesamten Framepuffer gleichzeitig anzuheften.

Syntax

DXGKCB_PINFRAMEBUFFERFORSAVE2 DxgkcbPinframebufferforsave2;

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

Parameter

[in] hAdapter

Ein Handle für einen Anzeigeadapter. Der Treiber stellt dieses Handle für das Standard/Lead-Gerät in der LDA-Kette (Linked Display Adapter) bereit.

[in/out] pPinFrameBufferForSave2

Zeiger auf eine DXGKARGCB_PINFRAMEBUFFERFORSAVE2-Struktur , die Informationen zum zu speichernden Framepuffer enthält.

Rückgabewert

DXGKCB_PINFRAMEBUFFERFORSAVE2 gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls wird ein entsprechender NTSTATUS-Fehlercode zurückgegeben.

Hinweise

Die ursprüngliche WDDM 2.4 IOMMU-Implementierung umfasste ein Paar Rückruffunktionen zum Abfragen des Arbeitsspeichers, der zum Speichern des Framepuffers erforderlich ist. Der Framepufferspeicherbereich wurde während der Initialisierung als Abschnittsobjekt erstellt, und der Treiber verwendete diese Rückrufe, um bei Bedarf eine IOMMU zugeordnete Region abzurufen.

Treiber, die Adressdeskriptorlisten (ADLs) verwenden, um logisches DMA-Neumapping zu unterstützen, implementieren DXGKCB_PINFRAMEBUFFERFORSAVE2 anstelle von DXGKARGCB_PINFRAMEBUFFERFORSAVE.

Der mit DXGKCB_PINFRAMEBUFFERFORSAVE2 angeheftete Arbeitsspeicher kann mithilfe des ursprünglichen DXGKCB_UNPINFRAMEBUFFERFORSAVE Rückrufs aufgehoben werden.

Weitere Informationen finden Sie unter IOMMU DMA Remapping .

DXGKCB_XXX Funktionen werden von Dxgkrnl implementiert. Um diese Rückruffunktion zu verwenden, legen Sie die entsprechenden Member von DXGKARGCB_PINFRAMEBUFFERFORSAVE2 fest, und rufen Sie dann DxgkCbPinFrameBufferForSave2 über die DXGKRNL_INTERFACE auf.