DXGKDDI_CLOSEALLOCATION Rückruffunktion (d3dkmddi.h)
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Zielplattform | Desktop |
| Kopfzeile | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |