SRB_INITIALIZE_DEVICE

  • Article

The class driver sends this request when it begins initializing the minidriver's hardware.

Return Value

The minidriver should set one of the following as the status in the SRB:

STATUS_SUCCESS
Indicates that a host adapter was found and the configuration information was successfully determined.

STATUS_IO_DEVICE_ERROR
Indicates that a host adapter was found, but there was an error in obtaining the configuration information. If possible, the error should be logged.

STATUS_NO_SUCH_DEVICE
Indicates that the supplied configuration information was invalid.

Comments

The class driver passes a pointer to a PORT_CONFIGURATION_INFORMATION structure in pSrb->CommandData.ConfigInfo. The pSrb pointer points to a HW_STREAM_REQUEST_BLOCK structure. The class driver fills out most fields in pSrb->CommandData.ConfigInfo with information that it gets about the device from the operating system. Under most circumstances, the minidriver only needs to fill in the StreamDescriptorSize member of ConfigInfo with the size of its HW_STREAM_DESCRIPTOR structure.