DXGKDDI_DESCRIBEALLOCATION Rückruffunktion (d3dkmddi.h)

Artikel
02/23/2024

Die DxgkDdiDescribeAllocation-Funktion ruft Informationen zu einer vorhandenen Zuordnung ab, die für das Microsoft DirectX-Grafikkernsubsystem sonst nicht 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 für einen Kontextblock, der einer Grafikkarte zugeordnet ist. Der Anzeige-Miniporttreiber hat dieses Handle zuvor für das DirectX-Grafikkernsubsystem im Ausgabeparameter MiniportDeviceContext der DxgkDdiAddDevice-Funktion bereitgestellt.

[in/out] pDescribeAllocation

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

Rückgabewert

DxgkDdiDescribeAllocation gibt bei Erfolg STATUS_SUCCESS zurück. Andernfalls wird einer der in "Ntstatus.h" definierten Fehlercodes zurückgegeben.

Hinweise

Da das DirectX-Grafikkernsubsystem nicht unbedingt Zuordnungsdatensätze verwaltet, ruft das Grafikkernsubsystem DxgkDdiDescribeAllocation auf, um anzufordern, dass der Anzeige-Miniporttreiber Informationen zu vorhandenen Zuordnungen zurückgibt. Derzeit muss der Anzeige-Miniporttreiber diese Informationen für die folgenden Zuordnungen zurückgeben können:

Zuordnungen, die ebenfalls Primärschlüssel sind (d. a. Zuordnungen, die der Benutzermodusanzeigetreiber erstellt hat, indem das Flag primäres Bitfeld im Flags-Element der D3DDDI_ALLOCATIONINFO-Struktur in einem Aufruf der pfnAllocateCb-Funktion festgelegt wurde).
Zuordnungen, die die Quelle einer Präsentation sein können (d. h. Zuordnungen, die durch den hSource-Member der DXGKARG_PRESENT-Struktur in einem Aufruf der DxgkDdiPresent-Funktion des Anzeigeminiporttreibers dargestellt werden).

DxgkDdiDescribeAllocation sollte als ausgelagert werden.