Fungsi GetVirtualDiskPhysicalPath (virtdisk.h)

Artikel
06/27/2024

Mengambil jalur ke objek perangkat fisik yang berisi hard disk virtual (VHD) atau file gambar CD atau DVD (ISO).

Sintaksis

DWORD GetVirtualDiskPhysicalPath(
  [in]            HANDLE VirtualDiskHandle,
  [in, out]       PULONG DiskPathSizeInBytes,
  [out, optional] PWSTR  DiskPath
);

Parameter

[in] VirtualDiskHandle

Handel ke disk virtual terbuka, yang harus dibuka menggunakan bendera VIRTUAL_DISK_ACCESS_GET_INFO. Untuk informasi tentang cara membuka disk virtual, lihat fungsi OpenVirtualDisk .

[in, out] DiskPathSizeInBytes

Ukurannya, dalam byte, dari buffer yang ditujukkan oleh parameter DiskPath.

[out, optional] DiskPath

Buffer target untuk menerima jalur perangkat disk fisik yang berisi disk virtual.

Mengembalikan nilai

Status permintaan.

Jika fungsi berhasil, nilai pengembalian ERROR_SUCCESS dan parameter DiskPath berisi penunjuk ke string yang diisi.

Jika fungsi gagal, nilai pengembalian adalah kode kesalahan dan nilai konten buffer yang disebutkan oleh parameter DiskPath tidak terdefinisi. Untuk informasi selengkapnya, lihat Kode Kesalahan Sistem .

Komentar

Agar fungsi GetVirtualDiskPhysicalPath berhasil, disk virtual yang dimaksud oleh parameter VirtualDiskHandle harus dilampirkan, objek disk fisik harus ditempatkan oleh sistem, dan parameter DiskPath harus merujuk ke buffer yang cukup besar untuk menahan jalur yang dihasilkan. Jalur ini dalam bentuk \\.\ PhysicalDriveX di mana X adalah bilangan bulat yang mewakili enumerasi tertentu dari disk fisik pada sistem pemanggil.

File gambar CD dan DVD (ISO) tidak didukung sebelum Windows 8 dan Windows Server 2012.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 7
server minimum yang didukung	Windows Server 2008 R2
Platform Target	Windows
Header	virtdisk.h
Pustaka	VirtDisk.lib
DLL	VirtDisk.dll

Lihat juga

Tentang VHD

Referensi VHD

Bagikan melalui