DXGKARGCB_MAPFRAMEBUFFERPOINTER-Struktur (d3dkmddi.h)

Die DXGKARGCB_MAPFRAMEBUFFERPOINTER-Struktur enthält Argumente, die von der DXGKCB_MAPFRAMEBUFFERPOINTER Rückruffunktion zum Zuordnen eines Framepufferzeigers verwendet werden.

Syntax

typedef struct _DXGKARGCB_MAPFRAMEBUFFERPOINTER {
  [in]     UINT   PhysicalAdapterIndex;
  [in]     SIZE_T Size;
  [in/out] SIZE_T Offset;
  [out]    PVOID  pBaseAddress;
} DXGKARGCB_MAPFRAMEBUFFERPOINTER;

Member

[in] PhysicalAdapterIndex

Der Index des physischen Adapters.

[in] Size

Die Größe des zugeordneten Unterbereichs des Abschnittsobjekts in Byte. Die Größe muss ein Vielfaches von PAGE_SIZE sein.

[in/out] Offset

Bei der Eingabe ist dies der Offset in Byte zum zugeordneten Unterbereich des Abschnittsobjekts. Offset muss ein Vielfaches von PAGE_SIZE sein. Bei der Ausgabe ist dies der Offset der Ausgabebasisadresse, in die der Treiber die Daten kopieren soll.

[out] pBaseAddress

Ein CPU-zugänglicher Basisadressenzeiger auf die zugeordnete Unterregion des Abschnittsobjekts. Der Treiber muss den Ausgabewert Offset der Basisadresse hinzufügen, um die Zieladresse aller Kopiervorgänge abzurufen (pDestinationAddress = pBaseAddress + Offset).

Hinweise

Wenn beim Anheften des abschnittsobjekts des gesamten Framepuffers ein Fehler auftritt, muss der Treiber versuchen, den Vorwärtsfortschritt sicherzustellen, indem er die Übertragung in kleineren Teilen ausführt. Dies wird erreicht, indem während der Initialisierungszeit ein kleiner MDL- oder Speicherblock zugewiesen wird, der zum Übertragen des Inhalts von der Hardware verwendet werden kann, und dann DXGKCB_MAPFRAMEBUFFERPOINTER aufrufen, um einen Zeiger auf einen Unterbereich des Abschnittsobjekts zu erhalten.

Der Treiber ist für das Kopieren der Daten aus dem vorab zugeordneten Puffer in die zugeordnete Unterregion verantwortlich. Umgekehrt gilt auch beim Wiederherstellen des Framepufferinhalts.

Weitere Informationen finden Sie unter IOMMU-basierte GPU-Isolation .

Anforderungen

Weitere Informationen

DXGKCB_MAPFRAMEBUFFERPOINTER