Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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