大网数据广告活动
Windows 系统接口

IVmFiovGuestMmioMappings::CreateSectionBackedMmioRange method

· 52CE 我爱测

Maps a section into device MMIO space, so that accesses to those addresses will be backed by the section.

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.

资料来源与适用范围

资料来源
Microsoft Learn / Windows Win32 documentation
适用范围
Windows Win32 API · Source date 02/08/2024
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。