Share via

VirtualSetPageFlags

  • Article

This function maps the VSPF_* flags to SH4 virtual page attribute flags and sets the flags for all the pages in the range specified by the lpvAddress and cbSize parameters. These flags correspond to bits in the page table entry assistance register. VirtualSetPageFlags should only be called by the SH4 PCMCIA driver.

BOOL VirtualSetPageFlags(
  LPVOID lpvAddress, 
  DWORD cbSize, 
  DWORD dwFlags, 
  LPDWORD lpdwOldFlags 
);

Parameters

  • lpvAddress
    [in] Starting virtual address of the memory region affected by VirtualSetPageFlags.

  • cbSize
    [in] Size of the lpvAddress memory region.

  • dwFlags
    [in] Contains the page flags to be applied to the memory region. The following table shows the valid flags.

    Flag Description
    VSPF_NONE Flag equal to 0.
    VSPF_8BIT Flag equal to 0 (default).
    VSPF_VARIABLE PCMCIA I/O space, data width is determined by the IOIS#16 signal.
    VSPF_IOSPACE PCMCIA I/O space, 8-bit data path width.
    VSPF_COMMON 8-bit PCMCIA common memory space.
    VSPF_ATTRIBUTE 8-bit PCMCIA attribute memory space.
    VSPF_16BIT Use in combination with another flag to implement 16-bit data path width.

    The following table shows the flag can be used with the flags in the previous table.

    Flag Description
    VSPF_TC Timing control for PCMCIA areas 5 and 6.

    If VSPF_TC is specified, timing control register 1 is used to control timing for the region. If VSPF_TC is not specified, then timing control register 0 is used. The PCMCIA driver does not use VSPF_TC.

    The following table shows other valid flag combinations.

    Flag Description
    VSPF_IOSPACE | VSPF_16BIT PCMCIA I/O space 16-bit data path width.
    VSPF_COMMON | VSPF_16BIT 16-bit PCMCIA common memory space.
    VSPF_ATTRIBUTE | VSPF_16BIT 16-bit PCMCIA attribute memory space.

  • lpdwOldFlags
    [out] Pointer to a DWORD to receive the previous set of page flags for the memory region so they can be restored if needed.

Return Values

If this function succeeds, it returns TRUE. If this function fails, it returns FALSE.

Remarks

The PCMCIA driver uses combinations of VSPF_IOSPACE, VSPF_COMMON, VSPF_ATTRIBUTE, VSPF_16BIT, VSPF_VARIABLE and VSPF_8BIT to map pages in the three PCMCIA memory spaces using 8-bit or 16-bit data path widths.

Requirements

OS Versions: Windows CE 3.0 and later.
Header: Pkfuncs.h.
Link Library: Coredll.lib.

See Also

Trusted APIs

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.