DXGKDDI_CLOSEALLOCATION Rückruffunktion (d3dkmddi.h)

Artikel
02/23/2024

Die DxgkDdiCloseAllocation-Funktion hebt die Bindung gerätespezifischer Zuordnungen auf, die von der DxgkDdiOpenAllocation-Funktion erstellt wurden.

Syntax

DXGKDDI_CLOSEALLOCATION DxgkddiCloseallocation;

NTSTATUS DxgkddiCloseallocation(
  [in] IN_CONST_HANDLE hDevice,
  [in] IN_CONST_PDXGKARG_CLOSEALLOCATION pCloseAllocation
)
{...}

Parameter

[in] hDevice

Ein Handle für das Grafikkontextgerät, von dem Zuordnungen aufgehoben werden. Die DxgkDdiCreateDevice-Funktion des Display-Miniporttreibers hat dieses Handle zuvor für das Microsoft DirectX-Grafikkernsystem im hDevice-Member der DXGKARG_CREATEDEVICE-Struktur bereitgestellt.

[in] pCloseAllocation

Ein Zeiger auf eine DXGKARG_CLOSEALLOCATION-Struktur , die Informationen zum Aufheben der Bindung von Zuordnungen enthält.

Rückgabewert

DxgkDdiCloseAllocation gibt STATUS_SUCCESS oder ein entsprechendes Fehlerergebnis zurück, wenn die Zuordnungen nicht erfolgreich vom Grafikkontextgerät aufgehoben werden.

Hinweise

Bevor der Anzeige-Miniporttreiber einen Aufruf seiner DxgkDdiDestroyAllocation-Funktion empfängt, um Zuordnungen freizugeben, ruft der Treiber die DxgkDdiCloseAllocation-Funktion auf, um alle Bindungen für diese Zuordnungen zu schließen.

Für eine Ressource, die mehrere Zuordnungen enthält, weist das DirectX-Grafikkernsubsystem DxgkDdiCloseAllocation an, alle Zuordnungen gleichzeitig zu schließen, indem die Handles für die gerätespezifischen Zuordnungen im pOpenHandleList-Element der DXGKARG_CLOSEALLOCATION-Struktur angegeben werden.

DxgkDdiCloseAllocation sollte als ausgelagert werden.