DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA Rückruffunktion (d3dkmddi.h)

2024-11-11

Die DxgkDdiGetStandardAllocationDriverData--Funktion gibt eine Beschreibung eines Standardzuordnungstyps zurück.

Syntax

DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA DxgkddiGetstandardallocationdriverdata;

NTSTATUS DxgkddiGetstandardallocationdriverdata(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARG_GETSTANDARDALLOCATIONDRIVERDATA pGetStandardAllocationDriverData
)
{...}

Parameter

[in] hAdapter

Ein Handle zu einem Kontextblock, der einem Anzeigeadapter zugeordnet ist. Der Kernelmodusanzeigetreiber (KERNEL-Mode Display Driver, KMD) hat dieses Handle zuvor für Dxgkrnl- in seiner DxgkDdiAddDevice--Funktion bereitgestellt.

[in/out] pGetStandardAllocationDriverData

Ein Zeiger auf eineDXGKARG_GETSTANDARDALLOCATIONDRIVERDATA Struktur, die eine Standardzuordnung beschreibt.

Rückgabewert

DxgkDdiGetStandardAllocationDriverData gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	DxgkDdiGetStandardAllocationDriverData erfolgreich eine Beschreibung des Standardzuordnungstyps zurückgegeben.
STATUS_NO_MEMORY	DxgkDdiGetStandardAllocationDriverData- konnte keinen Speicher zuordnen, der für den Abschluss erforderlich war.

Bemerkungen

Standardzuordnungstypen sind Zuordnungen, die im Kernelmodus erstellt werden müssen, ohne vom Anzeigetreiber für den Benutzermodus zu kommunizieren.

Dxgkrnl- ruft die KMD -DxgkDdiGetStandardAllocationDriverData--Funktion auf, um eine Beschreibung des Standardzuordnungstyps zu generieren, den der pGetStandardAllocationDriverData Parameter angibt. KMD gibt die Beschreibung des Zuordnungstyps in der pAllocationPrivateDriverData- und pResourcePrivateDriverData Member der DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA Struktur zurück, auf die der pGetStandardAllocationDriverData- parameter verweist. Dxgkrnl anschließend die Beschreibung an die DxgkDdiCreateAllocation Funktion übergibt, um die Zuordnung tatsächlich zu erstellen.

Ab Windows 7, wenn KMD einen Aufruf der DxgkDdiGetStandardAllocationDriverData--Funktion verarbeitet, um Zuordnungen für die GDI-Hardwarebeschleunigung zu erstellen, sollte der Treiber den Pitch der Zuordnung für sichtbare CPU-Zuordnungen festlegen, **pGetStandardAllocationDriverData->pCreateGdiSurfaceData->**Pitch.

DxgkDdiGetStandardAllocationDriverData- sollte seitenfähig gemacht werden.