IOCTL_MOUNTMGR_NEXT_DRIVE_LETTER IOCTL (mountmgr.h)

IOCTL ini memeriksa apakah volume yang diberikan memiliki huruf kandar. Jika sudah memiliki huruf kandar, atau jika volume memiliki entri database manajer pemasangan khusus yang menunjukkan bahwa itu tidak memerlukan huruf drive, rutinitas ini mengembalikan huruf drive saat ini (jika ada) dan tidak melakukan apa-apa. Jika volume yang diberikan tidak memiliki huruf kandar dan tidak memiliki entri database manajer pemasangan khusus yang menunjukkan bahwa volume tidak memerlukan huruf drive, huruf drive berikutnya yang tersedia ditetapkan ke volume. Jika nama perangkat nonpersisten volume dimulai dengan "\Device\Floppy", manajer pemasangan akan memeriksa huruf drive yang tersedia yang dimulai dengan huruf "A." Jika nama volume dimulai dengan "\Device\CdRom" manajer pemasangan akan memeriksa huruf drive yang tersedia yang dimulai dengan huruf drive "D." Dalam semua kasus lain, manajer pemasangan dimulai dengan huruf drive "C."

Kode utama

IRP_MJ_DEVICE_CONTROL

Buffer input

Klien manajer pemasangan menginisialisasi struktur MOUNTMGR_DRIVE_LETTER_TARGET, yang ditentukan dalam Mountmgr.h, di awal buffer di Irp-AssociatedIrp.SystemBuffer>. Klien harus menyisipkan nama volume target pada alamat yang ditujukan oleh anggota DeviceName[] dari struktur ini. Nama volume target adalah nama objek perangkat yang tidak konsisten yang terkait dengan volume (misalnya, "\Device\HarddiskVolume1").

Panjang buffer input

Parameters.DeviceIoControl.InputBufferLength di lokasi tumpukan I/O IRP menunjukkan ukuran, dalam byte, dari buffer input, yang harus lebih besar dari atau sama dengan sizeof(MOUNTMGR_DRIVE_LETTER_TARGET).

Buffer output

Manajer pemasangan menyisipkan huruf kandar saat ini atau huruf kandar yang baru ditetapkan (lihat diskusi sebelumnya) dalam struktur MOUNTMGR_DRIVE_LETTER_INFORMATION, yang ditentukan dalam Mountmgr.h, di awal buffer di Irp-AssociatedIrp.SystemBuffer>.

Panjang buffer output

Parameters.DeviceIoControl.OutputBufferLength di lokasi tumpukan I/O IRP menunjukkan ukuran, dalam byte, dari buffer output, yang harus lebih besar dari atau sama dengan sizeof(MOUNTMGR_DRIVE_LETTER_INFORMATION).

Blok status

Jika operasi berhasil , bidang Status diatur ke STATUS_SUCCESS.

Jika InputBufferLength kurang dari sizeof(MOUNTMGR_DRIVE_LETTER_TARGET) atau jika OutputBufferLength kurang dari sizeof(MOUNTMGR_DRIVE_LETTER_INFORMATION), bidang Status diatur ke STATUS_INVALID_PARAMETER.

Persyaratan

Persyaratan	Nilai
Header	mountmgr.h (termasuk Mountmgr.h)

Lihat juga

MOUNTMGR_DRIVE_LETTER_TARGET