Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | ntddchgr.h (enthalten Ntddchgr.h) |