virtdisk¶

Bindings for the Win32 VirtDisk API.

class gonto.win32.virtdisk.ATTACH_VIRTUAL_DISK_FLAG(*values)¶

Contains virtual disk attach request flags.

See: https://learn.microsoft.com/en-us/windows/win32/api/virtdisk/ne-virtdisk-attach_virtual_disk_flag

BYPASS_DEFAULT_ENCRYPTION_POLICY = 32¶

NONE = 0¶

NO_DRIVE_LETTER = 2¶

NO_LOCAL_HOST = 8¶

NO_SECURITY_DESCRIPTOR = 16¶

PERMANENT_LIFETIME = 4¶

READ_ONLY = 1¶

class gonto.win32.virtdisk.CREATE_VIRTUAL_DISK_FLAG(*values)¶

Contains virtual hard disk (VHD) creation flags.

See: https://learn.microsoft.com/en-us/windows/win32/api/virtdisk/ne-virtdisk-create_virtual_disk_flag

CREATE_BACKING_STORAGE = 8¶

DO_NOT_COPY_METADATA_FROM_PARENT = 4¶

FULL_PHYSICAL_ALLOCATION = 1¶

NONE = 0¶

PMEM_COMPATIBLE = 256¶

PRESERVE_PARENT_CHANGE_TRACKING_STATE = 32¶

PREVENT_WRITES_TO_SOURCE_DISK = 2¶

SPARSE_FILE = 128¶

USE_CHANGE_TRACKING_SOURCE_LIMIT = 16¶

VHD_SET_USE_ORIGINAL_BACKING_STORAGE = 64¶

class gonto.win32.virtdisk.CREATE_VIRTUAL_DISK_VERSION(*values)¶

Contains the version of the virtual disk CREATE_VIRTUAL_DISK_PARAMETERS structure to use in calls to virtual disk functions.

See: https://learn.microsoft.com/en-us/windows/win32/api/virtdisk/ne-virtdisk-create_virtual_disk_version

UNSPECIFIED = 0¶

VERSION_1 = 1¶

VERSION_2 = 2¶

VERSION_3 = 3¶

VERSION_4 = 4¶

class gonto.win32.virtdisk.CreateVirtualDiskParametersVersion1¶

Contains virtual hard disk (VHD) creation parameters, providing control over, and information about, the newly created virtual disk.

Warning

The version field MUST be set to VERSION_1.

See: https://learn.microsoft.com/en-us/windows/win32/api/virtdisk/ns-virtdisk-create_virtual_disk_parameters

block_size_in_bytes¶: Structure/Union member

guid¶: Structure/Union member

maximum_size¶: Structure/Union member

parent_path¶: Structure/Union member

sector_size_in_bytes¶: Structure/Union member

source_path¶: Structure/Union member

version¶: Structure/Union member

class gonto.win32.virtdisk.DETACH_VIRTUAL_DISK_FLAG(new_class_name, /, names, *, module=None, qualname=None, type=None, start=1, boundary=None)¶

Contains virtual disk detach request flags.

See: https://learn.microsoft.com/en-us/windows/win32/api/virtdisk/ne-virtdisk-detach_virtual_disk_flag

NONE = 0¶

class gonto.win32.virtdisk.OPEN_VIRTUAL_DISK_FLAG(*values)¶

Contains virtual hard disk (VHD) or CD or DVD image file (ISO) open request flags.

See: https://learn.microsoft.com/en-us/windows/win32/api/virtdisk/ne-virtdisk-open_virtual_disk_flag

BLANK_FILE = 2¶

BOOT_DRIVE = 4¶

CACHED_IO = 8¶

CUSTOM_DIFF_CHAIN = 16¶

IGNORE_RELATIVE_PARENT_LOCATOR = 128¶

NONE = 0¶

NO_PARENTS = 1¶

NO_WRITE_HARDENING = 256¶

PARENT_CACHED_IO = 32¶

VHDSET_FILE_ONLY = 64¶

class gonto.win32.virtdisk.VIRTUAL_DISK_ACCESS_MASK(*values)¶

Contains the bitmask for specifying access rights to a virtual hard disk (VHD) or CD or DVD image file (ISO).

See: https://learn.microsoft.com/en-us/windows/win32/api/virtdisk/ne-virtdisk-virtual_disk_access_mask-r1

ALL = 4128768¶

ATTACH_RO = 65536¶

ATTACH_RW = 131072¶

CREATE = 1048576¶

DETACH = 262144¶

GET_INFO = 524288¶

METAOPS = 2097152¶

NONE = 0¶

READ = 851968¶

WRITABLE = 3276800¶

class gonto.win32.virtdisk.VIRTUAL_STORAGE_TYPE(*values)¶

Device type identifier.

See: https://learn.microsoft.com/en-us/windows/win32/api/virtdisk/ns-virtdisk-virtual_storage_type#members

DEVICE_ISO = 1¶

DEVICE_UNKNOWN = 0¶

DEVICE_VHD = 2¶

DEVICE_VHDX = 3¶

class gonto.win32.virtdisk.VIRTUAL_STORAGE_TYPE_VENDOR(*values)¶

Vendor-unique identifier.

See: https://learn.microsoft.com/en-us/windows/win32/api/virtdisk/ns-virtdisk-virtual_storage_type#virtual_storage_type_vendor_microsoft-ec984aec-a0f9-47e9-901f-71415a66345b

MICROSOFT = b'\xecJ\x98\xec\xf9\xa0\xe9G\x90\x1fqAZf4['¶

UNKNOWN = None¶

class gonto.win32.virtdisk.VirtualStorageType¶

Contains the type and provider (vendor) of the virtual storage device.

See: https://learn.microsoft.com/en-us/windows/win32/api/virtdisk/ns-virtdisk-virtual_storage_type

device_id¶: Structure/Union member

guid¶: Structure/Union member

gonto.win32.virtdisk.lib = None¶: Binding of virtdisk.dll. See source code for a list of bound functions.