IOCTL_EHSTOR_DEVICE_GET_AUTHZ_STATE IOCTL (ehstorioctl.h)

This IOCTL is used to inform the owning driver for the IEEE 1667 device PDOs that the authorization state has changed. The owning driver may choose to change the state of the disk PDO in response to this IOCTL. In the case of EhStorClass.sys, the disk PDO is added or removed based on the authorization value in the input buffer of this IOCTL. Typically this IOCTL is issued by a UMDF authentication silo driver, such as the password or certificate driver, immediately following a successful silo operation which has changed the authentication state of the silo.

Major code

IRP_MJ_DEVICE_CONTROL

Input buffer

The input buffer at Irp->AssociatedIrp.SystemBuffer must contain a structure of type ACT_AUTHZ_STATE.

Input buffer length

The length of an ACT_AUTHZ_STATE structure.

Output buffer

None.

Output buffer length

None.

Status block

One of the following values may be returned in the Status field:

STATUS_SUCCESS - The authorization state for the ACT was successfully set according to the data contained in the input buffer.
STATUS_INVALID_BUFFER_SIZE - The input buffer length supplied is of incorrect size.

Requirements

Requirement Value
Header ehstorioctl.h (include EhStorIoctl.h)