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 particolare tipo.
Per una descrizione dei tipi di elemento possibili, vedere CHANGER_ELEMENT.
Codice principale
Buffer di input
Il buffer in corrispondenza di Irp->AssociatedIrp.SystemBuffer contiene i dati CHANGER_READ_ELEMENT_STATUS che indicano il tipo di elemento e il numero di elementi per cui restituire lo stato.
Se il chiamante imposta il membro VolumeTagInfo di CHANGER_READ_ELEMENT_STATUS su TRUE, lo stato dell'elemento restituito includerà informazioni sul tag del volume.
Lunghezza del buffer di input
Parameters.DeviceIoControl.InputBufferLength nel percorso 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 miniclasse del modificatore restituisce i dati di stato dell'elemento changer nel buffer in corrispondenza di 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 Flag membro 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 dell'elemento 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 di stato
Il campo Informazioni è impostato sul numero di byte restituiti. Il campo Stato è impostato su STATUS_SUCCESS oppure su STATUS_BUFFER_TOO_SMALL, STATUS_INFO_LENGTH_MISMATCH, STATUS_INSUFFICIENT_RESOURCES, STATUS_INVALID_ELEMENT_ADDRESS o STATUS_INVALID_PARAMETER.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | ntddchgr.h (include Ntddchgr.h) |