DXGKDDI_CLOSEALLOCATION Rückruffunktion (d3dkmddi.h)
Die DxgkDdiCloseAllocation- Funktion hebt gerätespezifische Zuordnungen auf, die vom 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 ungebunden sind. Die DxgkDdiCreateDevice-Funktion des Anzeige-Miniporttreibers stellt dieses Handle zuvor dem Microsoft DirectX-Grafik-Kernelsubsystem im hDevice Member der DXGKARG_CREATEDEVICE Struktur zur Verfügung.
[in] pCloseAllocation
Ein Zeiger auf eine DXGKARG_CLOSEALLOCATION-Struktur, die Informationen zum Aufheben der Zuordnung enthält.
Rückgabewert
DxgkDdiCloseAllocation gibt STATUS_SUCCESS zurück oder ein entsprechendes Fehlerergebnis, wenn die Zuordnungen nicht erfolgreich vom Grafikkontextgerät getrennt werden.
Bemerkungen
Bevor der Anzeigeminiporttreiber einen Aufruf seiner DxgkDdiDestroyAllocation Funktion empfängt, um Zuordnungen freizugeben, ruft der Treiber die DxgkDdiCloseAllocation--Funktion auf, um alle Bindungen an diese Zuordnungen zu schließen.
Für eine Ressource, die mehrere Zuordnungen enthält, leitet das DirectX-Grafik-Kernelsubsystem DxgkDdiCloseAllocation, um alle Zuordnungen gleichzeitig zu schließen, indem die Handles für die gerätespezifischen Zuordnungen in der pOpenHandleList Member der DXGKARG_CLOSEALLOCATION-Struktur angegeben werden.
DxgkDdiCloseAllocation sollte seitenfähig gemacht werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| Zielplattform- | Desktop |
| Header- | d3dkmddi.h |
| IRQL- | PASSIVE_LEVEL |