IOCTL_CHANGER_GET_ELEMENT_STATUS IOCTL (ntddchgr.h)

Artikel
02/29/2024

Mengembalikan status semua elemen atau status dari sejumlah elemen tertentu dari jenis tertentu.

Untuk deskripsi jenis elemen yang mungkin, lihat CHANGER_ELEMENT.

Kode utama

Buffer input

Buffer di Irp-AssociatedIrp.SystemBuffer> berisi data CHANGER_READ_ELEMENT_STATUS yang menunjukkan jenis elemen dan jumlah elemen untuk mengembalikan status.

Jika penelepon mengatur anggota VolumeTagInfo dari CHANGER_READ_ELEMENT_STATUS ke TRUE, status elemen yang dikembalikan akan menyertakan informasi tag volume.

Panjang buffer input

Parameters.DeviceIoControl.InputBufferLength di lokasi tumpukan I/O menunjukkan ukuran, dalam byte, dari buffer parameter untuk input, yang harus >= sizeof(CHANGER_READ_ELEMENT_STATUS).

Buffer output

Driver miniclass changer mengembalikan data status elemen changer di buffer di Irp-AssociatedIrp.SystemBuffer>. Beberapa elemen jenis ChangerDrive mengembalikan data informasi produk. Jika perangkat memberikan informasi produk, driver miniclass akan melaporkan data status elemen dalam struktur jenis CHANGER_ELEMENT_STATUS_EX. Driver miniclass mengatur ELEMENT_STATUS_PRODUCT_DATA di anggota Bendera struktur untuk menunjukkan bahwa ia berisi data informasi produk. Untuk elemen semua jenis selain ChangerDrive, driver melaporkan data status elemen dalam struktur jenis CHANGER_ELEMENT_STATUS.

Panjang buffer output

Parameters.DeviceIoControl.OutputBufferLength menunjukkan ukuran, dalam byte, dari buffer parameter untuk output. Untuk elemen jenis ChangerDrive, nilai ini harus >= NumberOfElements * sizeof(CHANGER_ELEMENT_STATUS_EX). Untuk elemen dari semua jenis lainnya, nilai ini harus >= NumberOfElements * sizeof(CHANGER_ELEMENT_STATUS).

Blok status

Bidang Informasi diatur ke jumlah byte yang dikembalikan. Bidang Status diatur ke STATUS_SUCCESS, atau mungkin ke STATUS_BUFFER_TOO_SMALL, STATUS_INFO_LENGTH_MISMATCH, STATUS_INSUFFICIENT_RESOURCES, STATUS_INVALID_ELEMENT_ADDRESS, atau STATUS_INVALID_PARAMETER.