IOCTL_CHANGER_GET_ELEMENT_STATUS IOCTL (ntddchgr.h)

Artikel
02/07/2025

Gibt den Status aller Elemente oder den Status einer angegebenen Anzahl von Elementen eines bestimmten Typs zurück.

Eine Beschreibung der möglichen Elementtypen finden Sie unter CHANGER_ELEMENT.

Hauptcode

Eingabepuffer

Der Puffer bei Irp->AssociatedIrp.SystemBuffer enthält die CHANGER_READ_ELEMENT_STATUS Daten, die den Elementtyp und die Anzahl der Elemente angibt, für die der Status zurückgegeben werden soll.

Wenn der Aufrufer das VolumeTagInfo Member von CHANGER_READ_ELEMENT_STATUS auf TRUEfestlegt, enthält der zurückgegebene Elementstatus Volumetaginformationen.

Eingabepufferlänge

Parameters.DeviceIoControl.InputBufferLength- an der I/O-Stapelposition gibt die Größe des Parameterpuffers für die Eingabe in Bytes an, die >= Sizeof(CHANGER_READ_ELEMENT_STATUS) sein muss.

Ausgabepuffer

Der Changer-Miniklassentreiber gibt die Statusdaten des Changerelements im Puffer bei Irp->AssociatedIrp.SystemBufferzurück. Einige Elemente vom Typ ChangerDrive Produktinformationsdaten zurückgeben. Wenn das Gerät Produktinformationen bereitstellt, meldet der Miniklassentreiber die Elementstatusdaten in einer Struktur vom Typ CHANGER_ELEMENT_STATUS_EX. Der Miniklassentreiber legt ELEMENT_STATUS_PRODUCT_DATA im Flags Element der Struktur fest, um anzugeben, dass er Produktinformationsdaten enthält. Für Elemente aller typen außer ChangerDrivemeldet der Treiber Elementstatusdaten in einer Struktur vom Typ CHANGER_ELEMENT_STATUS.

Länge des Ausgabepuffers

Parameters.DeviceIoControl.OutputBufferLength gibt die Größe des Parameterpuffers für die Ausgabe in Bytes an. Für Elemente vom Typ ChangerDrivemuss dieser Wert >= NumberOfElements * Größe(CHANGER_ELEMENT_STATUS_EX) sein. Für Elemente aller anderen Typen muss dieser Wert >= NumberOfElements * Größe(CHANGER_ELEMENT_STATUS) sein.

Statusblock

Das Feld Information wird auf die Anzahl der zurückgegebenen Bytes festgelegt. Das Feld Status wird auf STATUS_SUCCESS oder möglicherweise auf STATUS_BUFFER_TOO_SMALL, STATUS_INFO_LENGTH_MISMATCH, STATUS_INSUFFICIENT_RESOURCES, STATUS_INVALID_ELEMENT_ADDRESS oder STATUS_INVALID_PARAMETER festgelegt.