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.
Die IOCTL_EHSTOR_DEVICE_SET_QUEUE_STATE Anforderung wird von Silotreibern und Anwendungen gesendet, um den Status einer Speichergerätewarteschlange zu ändern. E/A-Anforderungen in der Speichergerätewarteschlange werden gehalten, wenn das Gerät vorübergehend nicht autorisiert ist.
Hauptcode
Eingabepuffer
Der Eingabepuffer bei Irp->AssociatedIrp.SystemBuffer enthält eine ACT_QUEUE_STATE Struktur. ACT_QUEUE_STATE wird in ehstorioctl.h wie folgt deklariert.
typedef struct tagACT_QUEUE_STATE
{
BOOLEAN fFrozen;
} ACT_QUEUE_STATE;
Eingabepufferlänge
Die Länge einer ACT_QUEUE_STATE Struktur.
Ausgabepuffer
Nichts.
Länge des Ausgabepuffers
Nichts.
Statusblock
Einer der folgenden Werte kann im Feld Status zurückgegeben werden.
| Statuswert | Beschreibung |
|---|---|
| STATUS_SUCCESS | Der Warteschlangenstatus wurde erfolgreich geändert. |
| STATUS_INVALID_BUFFER_SIZE | Die Länge des Eingabepuffers ist zu klein. |
| STATUS_ACCESS_DENIED | Die IOCTL-Anforderung wurde nicht von einem Silotreiber ausgestellt. |
Bemerkungen
Silotreiber oder Anwendungen können die E/A-Anforderungswarteschlange des Speichergeräts fixieren, wenn eine temporäre Nichtautorisierung erforderlich ist. In der Regel tritt die temporäre Nichtautorisierung während des Energiesparzustands auf oder wenn eine Richtlinie die Sperrung erweiterter Speichergeräte erfordert, z. B. eine gesperrte Benutzersitzung. In einem solchen Fall empfiehlt es sich, ausstehende E/A-Anforderungen in den Halteraum zu setzen, anstatt die E/A-Anforderungen fehlzuschlagen und Datenverlust zu verursachen.
Um den Missbrauch der IOCTL_EHSTOR_DEVICE_SET_QUEUE_STATE Anfrage durch Anwendungen zu verhindern, kann nur ein Treiber dieses IOCTL ausstellen. Wenn sie von einer Benutzermodusanwendung gesendet wird, schlägt diese Anforderung mit STATUS_ACCESS_DENIED fehl.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar ab Windows 8 |
| Header- | ehstorioctl.h (einschließlich EhStorIoctl.h) |