DXGKDDI_DESCRIBEALLOCATION Rückruffunktion (d3dkmddi.h)

Artikel
02/06/2025

Die DxgkDdiDescribeAllocation--Funktion ruft Informationen zu einer vorhandenen Zuordnung ab, die andernfalls nicht für das Microsoft DirectX-Grafik-Kernelsubsystem verfügbar ist.

Syntax

DXGKDDI_DESCRIBEALLOCATION DxgkddiDescribeallocation;

NTSTATUS DxgkddiDescribeallocation(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARG_DESCRIBEALLOCATION pDescribeAllocation
)
{...}

Parameter

[in] hAdapter

Ein Handle zu einem Kontextblock, der einem Anzeigeadapter zugeordnet ist. Der Display-Miniporttreiber hat dieses Handle zuvor dem DirectX-Grafikkernsubsystem im MiniportDeviceContext Ausgabeparameter des DxgkDdiAddDevice--Funktion bereitgestellt.

[in/out] pDescribeAllocation

Ein Zeiger auf eine DXGKARG_DESCRIBEALLOCATION Struktur, die eine vorhandene Zuordnung beschreibt.

Rückgabewert

DxgkDdiDescribeAllocation- gibt STATUS_SUCCESS zurück, wenn dies erfolgreich ist; andernfalls wird eine der in Ntstatus.hdefinierten Fehlercodes zurückgegeben.

Bemerkungen

Da das DirectX-Grafik-Kernelsubsystem nicht unbedingt Datensätze von Zuordnungen verwaltet, ruft das Grafikkernsubsystem DxgkDdiDescribeAllocation- auf, um anzufordern, dass der Anzeigeminiporttreiber Informationen zu vorhandenen Zuordnungen zurückgibt. Derzeit muss der Anzeige-Miniporttreiber in der Lage sein, diese Informationen für die folgenden Zuordnungen zurückzugeben:

Zuordnungen, die auch Primärzuordnungen sind (d. a. Zuordnungen, die der Vom Benutzermodusanzeigetreiber erstellt wurde, indem das Primäre Bitfeldflagge im Flags Mitglied der D3DDDI_ALLOCATIONINFO-Struktur in einem Aufruf der pfnAllocateCb--Funktion festgelegt wird).
Zuordnungen, die die Quelle einer Präsentation sein können (d. hSource-Zuordnungen, die durch das hSource- Mitglied der DXGKARG_PRESENT-Struktur in einem Aufruf der DxgkDdiPresent-Funktion des Anzeigeminiporttreibers dargestellt werden).

DxgkDdiDescribeAllocation- sollte seitenfähig gemacht werden.