Add c.s.j.win32.Psapi.QueryWorkingSetEx, c.s.j.win32.Kernel32.VirtualLock, c.s.j.win32.Kernel32.VirtualUnlock

[matthiasblaesing]

No description provided.

[dbwiddis]

LGTM, but given that the mappings don't exactly match the docs I'd prefer if the test could be performed on an array, to confirm the struct size/alignment of the array members.

[matthiasblaesing]

LGTM, but given that the mappings don't exactly match the docs I'd prefer if the test could be performed on an array, to confirm the struct size/alignment of the array members.

Valid point. I rewrote the test to use an array as basis: 1fa2c15

Was this what you were thinking about?

[dbwiddis]

Was this what you were thinking about?

Far more than I was thinking! But looks great.

[matthiasblaesing]

Appveyor and travis are finally happy.

@dbwiddis thank you for review/feedback

@Crain-32 you can use this immediately with JNA/JNA-platform 5.12.1, by creating a local interface with the definition that derives from Psapi. In your code you use then PsapiExt instead of Psapi:

public interface PsapiExt extends Psapi {
    Psapi INSTANCE = Native.load("psapi", Psapi.class, W32APIOptions.DEFAULT_OPTIONS);
    
    boolean QueryWorkingSetEx(HANDLE hProcess, Pointer pv, int cb);
    
    @FieldOrder({"VirtualAddress", "VirtualAttributes"})
    class PSAPI_WORKING_SET_EX_INFORMATION extends Structure {

        public Pointer VirtualAddress;
        public ULONG_PTR VirtualAttributes;

        /**
         * If this bit is 1, the subsequent members are valid; otherwise they
         * should be ignored.
         */
        public boolean isValid() {
            return getBitFieldValue(1, 0) == 1;
        }

        /**
         * The number of processes that share this page. The maximum value of
         * this member is 7.
         */
        public int getShareCount() {
            return getBitFieldValue(3, 1);
        }

        /**
         * The memory protection attributes of the page. For a list of values
         * see below.
         *
         * @see
         * <a href="https://docs.microsoft.com/en-us/windows/desktop/Memory/memory-protection-constants">Memory
         * Protection Constants</a>.
         */
        public int getWin32Protection() {
            return getBitFieldValue(11, 3 + 1);
        }

        /**
         * If this bit is 1, the page can be shared.
         */
        public boolean isShared() {
            return getBitFieldValue(1, 11 + 3 + 1) == 1;
        }

        /**
         * The NUMA node. The maximum value of this member is 63.
         */
        public int getNode() {
            return getBitFieldValue(6, 1 + 11 + 3 + 1);
        }

        /**
         * If this bit is 1, the virtual page is locked in physical memory.
         */
        public boolean isLocked() {
            return getBitFieldValue(1, 6 + 1 + 11 + 3 + 1) == 1;
        }

        /**
         * If this bit is 1, the page is a large page.
         */
        public boolean isLargePage() {
            return getBitFieldValue(1, 1 + 6 + 1 + 11 + 3 + 1) == 1;
        }

        /**
         * If this bit is 1, the page is has been reported as bad.
         */
        public boolean isBad() {
            return getBitFieldValue(1, 1 + 1 + 1 + 6 + 1 + 11 + 3 + 1) == 1;
        }

        /**
         * Returns innerValue after shifting the value rightShiftAmount, and
         * applying a Bit Mask of size maskLength. Example, <br/>
         * innerValue = 0011<br/> getBitFieldValue(2, 1) = 0011 >> 1 & 11 = 01
         *
         * @param maskLength Size of the Bit Mask
         * @param rightShiftAmount Amount to Shift innerValue to the right by
         * @return innerValue with the mask and shift applied.
         */
        private int getBitFieldValue(final int maskLength, final int rightShiftAmount) {
            long bitMask = 0;

            for (int l = 0; l < maskLength; l++) {
                bitMask |= 1 << l;
            }
            return (int) ((VirtualAttributes.longValue() >>> rightShiftAmount) & bitMask);
        }
    }
}