IOCTL_CHANGER_GET_ELEMENT_STATUS IOCTL (ntddchgr.h)
Restituisce lo stato di tutti gli elementi o dello stato di un numero specificato di elementi di un determinato tipo.
Per una descrizione dei tipi di elementi possibili, vedere CHANGER_ELEMENT.
Codice principale
Buffer di input
Il buffer in Irp-AssociatedIrp.SystemBuffer> contiene i dati CHANGER_READ_ELEMENT_STATUS che indicano il tipo di elemento e il numero di elementi per i quali restituire lo stato.
Se il chiamante imposta il membro VolumeTagInfo di CHANGER_READ_ELEMENT_STATUS su TRUE, lo stato dell'elemento restituito includerà le informazioni sul tag del volume.
Lunghezza del buffer di input
Parameters.DeviceIoControl.InputBufferLength nella posizione dello stack I/O indica le dimensioni, in byte, del buffer dei parametri per l'input, che deve essere >= sizeof(CHANGER_READ_ELEMENT_STATUS).
Buffer di output
Il driver di miniclasse changer restituisce i dati sullo stato dell'elemento changer nel buffer in Irp-AssociatedIrp.SystemBuffer>. Alcuni elementi di tipo ChangerDrive restituiscono dati sulle informazioni sul prodotto. Se il dispositivo fornisce informazioni sul prodotto, il driver miniclasse segnala i dati sullo stato dell'elemento in una struttura di tipo CHANGER_ELEMENT_STATUS_EX. Il driver miniclasse imposta ELEMENT_STATUS_PRODUCT_DATA nel membro Flags della struttura per indicare che contiene dati sulle informazioni sul prodotto. Per gli elementi di tutti i tipi diversi da ChangerDrive, il driver segnala i dati sullo stato degli elementi in una struttura di tipo CHANGER_ELEMENT_STATUS.
Lunghezza del buffer di output
Parameters.DeviceIoControl.OutputBufferLength indica le dimensioni, in byte, del buffer dei parametri per l'output. Per gli elementi di tipo ChangerDrive, questo valore deve essere >= NumberOfElements * sizeof(CHANGER_ELEMENT_STATUS_EX). Per gli elementi di tutti gli altri tipi, questo valore deve essere >= NumberOfElements * sizeof(CHANGER_ELEMENT_STATUS).
Blocco dello stato
Il campo Informazioni viene impostato sul numero di byte restituiti. Il campo Stato è impostato su STATUS_SUCCESS o su STATUS_BUFFER_TOO_SMALL, STATUS_INFO_LENGTH_MISMATCH, STATUS_INSUFFICIENT_RESOURCES, STATUS_INVALID_ELEMENT_ADDRESS o STATUS_INVALID_PARAMETER.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | ntddchgr.h (include Ntddchgr.h) |