IOCTL_EHSTOR_DRIVER_REPORT_CAPABILITIES IOCTL (ehstorioctl.h)
Diese IOCTL wird verwendet, um den EHSTOR-Klassentreiber (Enhanced Storage) über die Funktionen des Silotreibers zu informieren. Der Silotreiber sendet diese IOCTL mit einer SILO_DRIVER_CAPABILITES Struktur, die angibt, ob Authentifizierung und Banding unterstützt werden, zusammen mit einer Liste von EHSTOR-IOCTLs, die verarbeitet werden.
Hauptcode
Eingabepuffer
Der Eingabepuffer bei Irp-AssociatedIrp.SystemBuffer> muss eine Struktur vom Typ SILO_DRIVER_CAPABILITES enthalten. Auf diese Struktur folgt sofort eine Liste der umgeleiteten IOCTLs, die vom Silotreiber verarbeitet werden.
Länge des Eingabepuffers
Die Länge des Puffers.
Ausgabepuffer
Keine.
Länge des Ausgabepuffers
Keine.
Statusblock
Einer der folgenden Werte kann im Feld Status zurückgegeben werden.
| Statuswert | BESCHREIBUNG |
|---|---|
| STATUS_SUCCESS | Die Funktionen des Silotreibers wurden beim EHSTOR-Klassentreiber registriert. |
| STATUS_INVALID_BUFFER_SIZE | Die angegebene Länge des Eingabepuffers hat eine falsche Größe. |
| STATUS_INVALID_PARAMETER | Ein Funktionsparameter ist falsch. |
| STATUS_INSUFFICIENT_RESOURCES | Die IOCTL-Umleitungsliste kann nicht kopiert werden. |
| STATUS_NOT_SUPPORTED | Das sendenden Gerät ist kein Silogerät. |
Hinweise
Diese IOCTL wird vom TCG-Standard-Authentifizierungssilostreiber (Trusted Computing Group) in Windows 8 verwendet. Bei der Geräteinitialisierung benachrichtigt der TCG-Silotreiber den EHSTOR-Klassentreiber (EhStorClass.sys) über seine Funktionen, indem er eine IOCTL_EHSTOR_DRIVER_REPORT_CAPABILITIES-Anforderung mit einer SILO_DRIVER_CAPABILITIES-Struktur sendet.
Silogeräteobjekte sind außerhalb des Speichergerätestapels vorhanden. Alle EHSTOR-Anforderungen, die für einen Silotreiber vorgesehen sind, müssen explizit an diesen weitergeleitet werden. Dies gilt für alle Bandverwaltungs-IOCTLs. Bandverwaltungsanforderungen werden für ein Dateiobjekt gestellt, das ein physisches Laufwerk darstellt. Diese Anforderungen werden auf dem Speichergerätestapel gesendet. Wenn der Silotreiber unterstützung für die IOCTL registriert hat, leitet der EHSTOR-Klassentreiber die Anforderung an den Silotreiber um.
IOCTL-Anforderungen, die von einem Silotreiber unterstützt werden, sind in einem Array enthalten, das SILO_DRIVER_CAPABILITIES im Systempuffer folgt. Die Größe der Informationen im Systempuffer sollte als sizeof(SILO_DRIVER_CAPABILITIES) + (sizeof(ULONG) * RedirectedIoctlListCount) angegeben werden.
Ein vom Anbieter bereitgestellter Nicht-TCG-Authentifizierungssilostreiber muss den EHSTOR-Klassentreiber mithilfe dieser IOCTL über seine Funktionen informieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 8 |
| Kopfzeile | ehstorioctl.h (include EhStorIoctl.h) |