Maps a section into device MMIO space, so that accesses to those addresses will be backed by the section. The caller is responsible for pausing and resuming the VPs around this call if the updates to the device space are to appear atomic.
Syntax
HRESULT CreateSectionBackedMmioRange(
[in] FIOV_BAR_SELECTOR BarIndex,
[in] ULONG64 BarOffsetInPages,
[in] UINT64 PageCount,
[in] FiovMmioMappingFlags MappingFlags,
[in, system_handle(sh_section)] HANDLE SectionHandle,
[in] UINT64 SectionOffsetInPages
);
Parameters
BarIndex [in]
The index of the BAR containing MMIO space.
BarOffsetInPages [in]
The offset within the BAR to the first page to be mapped.
PageCount [in]
The number of pages from the section mapped into MMIO space.
MappingFlags [in]
Specifies flags used when creating the guest mapping.
SectionHandle [in]
The handle to the section object.
SectionOffsetInPages [in]
The offset within the section to the first page to map.
Return value
An HRESULT.
Remarks
The FIOV_BAR_SELECTOR enumeration that provides values for the BarIndex is documented in the remarks of RegisterDoorbell.
The FiovMmioMappingFlags enumeration that provides values for the MappingFlags has the following definition:
typedef [v1_enum] enum
{
FiovMmioMappingFlagNone = 0x00000000,
FiovMmioMappingFlagWriteable = 0x00000001,
FiovMmioMappingFlagExecutable = 0x00000002
} FiovMmioMappingFlags;
Requirements
| Requirement | Value |
|---|---|
| Header | N/A |
See also
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
