DXGKDDI_DESTROYMEMORYBASIS Rückruffunktion (d3dkmddi.h)
Die DxgkDdiDestroyMemoryBasis-Funktion von KMD zerstört eine Speicherbasis, die durch einen vorherigen Aufruf von DxgkDdiCreateMemoryBasis erstellt wurde.
Syntax
DXGKDDI_DESTROYMEMORYBASIS DxgkddiDestroymemorybasis;
NTSTATUS DxgkddiDestroymemorybasis(
IN_CONST_HANDLE hAdapter,
IN_CONST_HANDLE hMemoryBasis
)
{...}
Parameter
hAdapter
[in] Ein Handle für einen Kontextblock, der einer Grafikkarte zugeordnet ist. KMD hat dieses Handle zuvor für Dxgkrnl im MiniportDeviceContext-Ausgabeparameter der DxgiDdiAddDevice-Funktion bereitgestellt.
hMemoryBasis
Handle für die Speicherbasis, die zerstört werden soll. Dieses Handle wurde zuvor durch einen Aufruf von DxgkDdiCreateMemoryBasis erstellt.
Rückgabewert
DxgkDdiDestroyMemoryBasis gibt STATUS_SUCCESS zurück, wenn die Speicherbasis erfolgreich zerstört wurde. Andernfalls wird ein NTSTATUS-Fehlercode zurückgegeben. Siehe Hinweise.
Hinweise
Dxgkrnl interpretiert alle zurückgegebenen NTSTATUS-Instanzen, die nicht STATUS_SUCCESS sind, als Rückgabe einer katastrophalen Fehlerbenachrichtigung. Es sollte keinen ordnungsgemäß funktionierenden Pfad geben, um von dieser Funktion nur Erfolg zurückzugeben, da davon ausgegangen werden sollte, dass das bereitgestellte Handle eines ist, das erstellt wurde und noch nicht zerstört wurde. Wenn KMD fehlerhafte Eingaben erkennt, kann dxgkrnl mit einem zurückgegebenen Fehlercode den invarianten Fehler dem Betriebssystemkernkern anstelle eines Treiberabsturzes zuweisen.
Weitere Informationen finden Sie unter Dirty Bit Tracking.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 11, Version 24H2 (WDDM 3.2) |
| Kopfzeile | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |