Fungsi IoVolumeDeviceToDosName (ntddk.h)

  • Artikel

Rutinitas IoVolumeDeviceToDosName mengembalikan jalur MS-DOS untuk objek perangkat tertentu yang mewakili volume sistem file.

Sintaks

NTSTATUS IoVolumeDeviceToDosName(
  [in]  PVOID           VolumeDeviceObject,
  [out] PUNICODE_STRING DosName
);

Parameter

[in] VolumeDeviceObject

Penunjuk ke objek perangkat yang mewakili objek perangkat volume yang dibuat oleh driver kelas penyimpanan.

[out] DosName

Penunjuk ke struktur UNICODE_STRING yang dialokasikan penelepon. Jika panggilan berhasil, IoVolumeDeviceToDosName menetapkan nilai anggota Length, MaximumLength, dan Buffer dari struktur ini. Saat keluar, anggota Buffer menunjuk ke string karakter lebar dan dihentikan null yang berisi jalur MS-DOS dari objek perangkat volume yang ditentukan oleh VolumeDeviceObject. Untuk informasi selengkapnya, lihat Keterangan.

Nilai kembali

IoVolumeDeviceToDosName mengembalikan STATUS_SUCCESS jika panggilan berhasil. Kemungkinan nilai pengembalian kesalahan mencakup kode status berikut.

Mengembalikan nilai Deskripsi
STATUS_INVALID_PARAMETER Rutinitas gagal karena nilai parameter yang tidak valid yang diteruskan oleh pemanggil.
STATUS_INSUFFICIENT_RESOURCES Rutinitas gagal mengalokasikan sumber daya yang diperlukan untuk operasi ini.

Keterangan

IoVolumeDeviceToDosName mengalokasikan buffer string yang diarahkan oleh anggota Buffer dari struktur UNICODE_STRING yang ditujukan parameter DosName . Setelah buffer ini tidak lagi diperlukan, pemanggil rutinitas ini harus memanggil rutinitas ExFreePool untuk membebaskan buffer.

Dimulai dengan Windows Vista, Anda harus memastikan bahwa APC tidak dinonaktifkan sebelum memanggil rutinitas ini. Rutinitas KeAreAllApcsDisabled dapat digunakan untuk memverifikasi bahwa APC tidak dinonaktifkan.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Header ntddk.h (termasuk Ntddk.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Lihat juga

ExFreePool

KeAreAllApcsDisabled

UNICODE_STRING