VirtDisk.h QueryChangesVirtualDisk() 函数 return RangeCount 为 0

Question

https://docs.microsoft.com/ko-kr/windows/win32/api/virtdisk/nf-virtdisk-querychangesvirtualdisk?redirectedfrom=MSDN

DWORD QueryChangesVirtualDisk(
  HANDLE                            VirtualDiskHandle,
  PCWSTR                            ChangeTrackingId,
  ULONG64                           ByteOffset,
  ULONG64                           ByteLength,
  QUERY_CHANGES_VIRTUAL_DISK_FLAG   Flags,
  PQUERY_CHANGES_VIRTUAL_DISK_RANGE Ranges,
  PULONG                            RangeCount,
  PULONG64                          ProcessedLength
);

我正在尝试区分两个虚拟磁盘或两个 Resillent Change Tracking ID (RCT)

但 RangeCount 始终 return 为 0

我用两个枚举参数 VIRTUAL_DISK_ACCESS_GET_INFO、OPEN_VIRTUAL_DISK_FLAG_NONE

打开了虚拟磁盘文件 (vhdx)

opStatus = OpenVirtualDisk(
        &storageType,
        VirtualDiskPath,
        VIRTUAL_DISK_ACCESS_GET_INFO,
        OPEN_VIRTUAL_DISK_FLAG_NONE,
        NULL,
        &vhdHandle ); // output handle

然后使用QueryChangesVirtualDisk()

opStatus = QueryChangesVirtualDisk(
    vhdHandle,
    ChangeTrackingId,
    0,
    32212254720,
    QUERY_CHANGES_VIRTUAL_DISK_FLAG_NONE,
    pRctRanges,
    &rctRangeCnt,
    &processedLength
    );

OpenVirtualDisk() QueryChangesVirtualDisk()

两个函数都没有 return 错误，但在每种情况下 RangeCount 的值始终为 0

虚拟磁盘文件和RCT ID肯定是有区别的

请多多指教

#include <windows.h>
#include <stdio.h>
#include <stdlib.h>
#include <initguid.h>
#include <strsafe.h>
#include <virtdisk.h>

#include "Storage.h"

DWORD QueryChangesVirtualDisk(_In_    LPCWSTR     VirtualDiskPath, _In_    LPCWSTR     ChangeTrackingId)
{
    VIRTUAL_STORAGE_TYPE storageType;
    PGET_VIRTUAL_DISK_INFO diskInfo;
    ULONG diskInfoSize;
    DWORD opStatus;

    HANDLE vhdHandle;

    QUERY_CHANGES_VIRTUAL_DISK_RANGE *pRctRanges;
    ULONG                            rctRangeCnt;
    ULONG64                          processedLength;
    UINT                             i;

    vhdHandle = INVALID_HANDLE_VALUE;
    diskInfo = NULL;
    diskInfoSize = sizeof(GET_VIRTUAL_DISK_INFO);

    rctRangeCnt = 0L;
    processedLength = 0L;
    pRctRanges = NULL;

    i = 0;

    diskInfo = (PGET_VIRTUAL_DISK_INFO)malloc(diskInfoSize);
    if (diskInfo == NULL)
    {
        opStatus = ERROR_NOT_ENOUGH_MEMORY;
        goto Cleanup;
    }

    storageType.DeviceId = VIRTUAL_STORAGE_TYPE_DEVICE_UNKNOWN;
    storageType.VendorId = VIRTUAL_STORAGE_TYPE_VENDOR_UNKNOWN;

    //////////////////////////////////////////////////////////////////

    opStatus = OpenVirtualDisk(
        &storageType,
        VirtualDiskPath,
        VIRTUAL_DISK_ACCESS_GET_INFO,
        OPEN_VIRTUAL_DISK_FLAG_NONE,
        NULL,
        &vhdHandle);

    if (opStatus != ERROR_SUCCESS)
    {
        wprintf(L"OpenVirtualDisk fail\n");
        goto Cleanup;
    }

    opStatus = QueryChangesVirtualDisk(
        vhdHandle,
        ChangeTrackingId,
        0,
        32212254720,
        QUERY_CHANGES_VIRTUAL_DISK_FLAG_NONE,
        pRctRanges,
        &rctRangeCnt,
        &processedLength
        );

    wprintf(L"rctRangeCnt : %lu\n", rctRangeCnt);
    wprintf(L"processedLength : %llu\n", processedLength);

    for (i = 0; i < rctRangeCnt; i++)
    {
        wprintf(L"ByteOffset : %lld   ByteLength : %lld\n", pRctRanges[i].ByteOffset, pRctRanges[i].ByteLength);
    }

    if (opStatus != ERROR_SUCCESS)
    {
        wprintf(L"QueryChangesVirtualDisk fail\n");
        goto Cleanup;
    }

Cleanup:

    if (opStatus == ERROR_SUCCESS)
    {
        wprintf(L"success\n");
    }
    else
    {
        wprintf(L"error = %u\n", opStatus);
    }

    if (vhdHandle != INVALID_HANDLE_VALUE)
    {
        CloseHandle(vhdHandle);
    }

    if (diskInfo != NULL)
    {
        free(diskInfo);
    }

    if (pRctRanges != NULL)
    {
        for (i = 0; i < rctRangeCnt; i++)
        {
            free(&pRctRanges[i]);
        }
    }

    return opStatus;
}

Answer 1

问题是您为 Ranges 参数传递了一个空指针，为 RangeCount.

传递了一个零指针

对于 Ranges 你应该传递一个指向第一个元素的指针或 QUERY_CHANGES_VIRTUAL_DISK_RANGE 元素的数组，并且 RangeCount 应该被初始化为元素的数量那个数组。

当 QueryChangesVirtualDisk 函数 returns 时，它会将 RangeCount 修改为 Ranges 数组中初始化元素的数量。

根据您链接到的文档，关于 RangeCount 参数：

On input, the value indicates the number of QUERY_CHANGES_VIRTUAL_DISK_RANGE structures that the array that the Ranges parameter points to can hold. On output, the value contains the number of QUERY_CHANGES_VIRTUAL_DISK_RANGE structures that the method placed in the array.

简而言之：该函数不会为您创建此数组，您必须在调用该函数之前创建该数组。

VirtDisk.h QueryChangesVirtualDisk() 函数 return RangeCount 为 0

VirtDisk.h QueryChangesVirtualDisk() function return RangeCount as 0

c++

hyper-v

change-tracking

virtual-disk

windows-server-2016