IOCTL_EHSTOR_DRIVER_REPORT_CAPABILITIES IOCTL (ehstorioctl.h)
Diese IOCTL wird verwendet, um den EHSTOR-Klassentreiber über die Funktionen des Silotreibers zu informieren. Der Silotreiber sendet diese IOCTL mit einer SILO_DRIVER_CAPABILITES Struktur, die angibt, ob Authentifizierung und Bandierung zusammen mit einer Liste der EHSTOR IOCTLs unterstützt werden, die verarbeitet werden.
Hauptcode
Eingabepuffer
Der Eingabepuffer bei Irp->AssociatedIrp.SystemBuffer muss eine Struktur vom Typ SILO_DRIVER_CAPABILITESenthalten. Auf diese Struktur folgt sofort eine Liste der umgeleiteten IOCTLs, die der Silotreiber verarbeiten wird.
Eingabepufferlänge
Die Länge des Puffers.
Ausgabepuffer
Nichts.
Länge des Ausgabepuffers
Nichts.
Statusblock
Einer der folgenden Werte kann im Feld Status zurückgegeben werden.
| Statuswert | Beschreibung |
|---|---|
| STATUS_SUCCESS | Die Funktionen des Silofahrers wurden beim EHSTOR-Klassentreiber registriert. |
| STATUS_INVALID_BUFFER_SIZE | Die angegebene Eingabepufferlänge weist eine falsche Größe auf. |
| STATUS_INVALID_PARAMETER | Ein Funktionsparameter ist falsch. |
| STATUS_INSUFFICIENT_RESOURCES | Die IOCTL-Umleitungsliste kann nicht kopiert werden. |
| STATUS_NOT_SUPPORTED | Das Sendegerät ist kein Silogerät. |
Bemerkungen
Diese IOCTL wird vom Standardauthentifizierungssilostreiber der Trusted Computing Group (TCG) 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 ihn weitergeleitet werden. Dies ist für alle Bandverwaltungs-IOCTLs der Fall. Bandverwaltungsanforderungen werden auf einem Dateiobjekt vorgenommen, das ein physisches Laufwerk darstellt. Diese Anforderungen werden an den Speichergerätestapel gesendet. Wenn der Silotreiber Unterstützung für die IOCTL registriert hat, leitet der EHSTOR-Klassentreiber die Anforderung an den Silotreiber weiter.
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 Größe(SILO_DRIVER_CAPABILITIES) + (Sizeof(ULONG) * RedirectedIoctlListCount) angegeben werden.
Ein Anbieter, der keinen TCG-Authentifizierungssilostreiber bereitgestellt hat, muss den EHSTOR-Klassentreiber über seine Funktionen mit dieser IOCTL benachrichtigen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar ab Windows 8 |
| Header- | ehstorioctl.h (einschließlich EhStorIoctl.h) |