Skip to content

Latest commit

 

History

History
91 lines (68 loc) · 2.26 KB

nc-dispmprt-dxgkddi_getmmiorangecount.md

File metadata and controls

91 lines (68 loc) · 2.26 KB
Raw
UID title description ms.date keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.lib req.dll req.irql req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library targetos tech.root ms.custom f1_keywords topic_type api_type api_location api_name dev_langs
NC:dispmprt.DXGKDDI_GETMMIORANGECOUNT
DXGKDDI_GETMMIORANGECOUNT (dispmprt.h)
Gets the number of memory ranges in the virtual device's MMIO (memory mapped input output) BARs.
10/19/2018
DXGKDDI_GETMMIORANGECOUNT callback function
dispmprt.h
Windows 10, version 1809
PASSIVE_LEVEL
Windows
display
RS5
DXGKDDI_GETMMIORANGECOUNT
dispmprt/DXGKDDI_GETMMIORANGECOUNT
apiref
UserDefined
dispmprt.h
DXGKDDI_GETMMIORANGECOUNT
c++

DXGKDDI_GETMMIORANGECOUNT callback function

-description

Gets the number of memory ranges in the virtual device's MMIO (memory mapped input output) BARs (base address registers).

-parameters

-param Context

A handle to the device context.

-param pArgs

Pointer to a DXGKARG_GETMMIORANGECOUNT structure.

-returns

Returns:

  • STATUS_SUCCESS The IHV system did not encounter any errors.
  • STATUS_INVALID_DEVICE_REQUEST The virtual device encountered an error and should be forcibly stopped. Failure here will cause virtual device failure.

-prototype

//Declaration

DXGKDDI_GETMMIORANGECOUNT DxgkddiGetmmiorangecount; 

// Definition

NTSTATUS DxgkddiGetmmiorangecount 
(
	HANDLE Context
	DXGKARG_GETMMIORANGECOUNT * pArgs
)
{...}

-remarks

This function will get the total count of memory rages that make up each of the virtual device BARs. Each range represent a group of pages that is either directly mapped from one of the physical device BARs, intercepted by the software virtual device (but still backed by physical device memory), or completely virtual and not mapped.

Note that if a device is fully virtual, and does not require any intercepts or virtual pages, this function can be unimplemented and NULL in the interface.

-see-also