DXGKDDI_DESTROYMEMORYBASIS - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// d3dkmddi.h
DXGKDDI_DESTROYMEMORYBASIS DxgkddiDestroymemorybasis;
NTSTATUS DxgkddiDestroymemorybasis(
IN_CONST_HANDLE hAdapter,
IN_CONST_HANDLE hMemoryBasis
)
{...}
View the official Windows Driver Kit DDI referenceNo description available.
KMD's DxgkDdiDestroyMemoryBasis function destroys a memory basis that was created by a previous call to DxgkDdiCreateMemoryBasis.
hAdapter[in] A handle to a context block associated with a display adapter. KMD previously provided this handle to Dxgkrnl in the MiniportDeviceContext output parameter of the DxgiDdiAddDevice function.
hMemoryBasisHandle to the memory basis to destroy. This handle was previously created by a call to DxgkDdiCreateMemoryBasis.
DxgkDdiDestroyMemoryBasis returns STATUS_SUCCESS if the memory basis was successfully destroyed. Otherwise, it returns an NTSTATUS error code. See Remarks.
Dxgkrnl interprets any returned NTSTATUS that isn't STATUS_SUCCESS as a catastrophic error notification return. There should be no correct-functioning path to return anything but success from this function, as it should be an assumed invariant that the supplied handle is one that was created and has not yet been destroyed. If KMD detects bad input, a returned error code lets Dxgkrnl assign the invariant failure to the OS kernel instead of a driver crash.
For more information, see Dirty bit tracking.