HwStorWmiQueryReginfo routine

A miniport driver's HwStorWmiQueryReginfo routine is called to obtain information about the data and event blocks to be registered on behalf of the miniport driver by the SCSI port driver.

Syntax


UCHAR HwStorWmiQueryReginfo(
  IN PVOID DeviceContext,
  IN PSCSIWMI_REQUEST_CONTEXT RequestContext,
  OUT PWCHAR *MofResourceName
);

Parameters

DeviceContext

A pointer to the miniport driver-defined context value passed to ScsiPortWmiDispatchFunction.

RequestContext

A pointer to the SCSIWMI_REQUEST_CONTEXT structure that the miniport driver passed to ScsiPortWmiDispatchFunction.

MofResourceName

A pointer to a null-terminated Unicode string that indicates the name of the MOF resource attached to the miniport driver's binary image file. This string can be declared as a constant in the miniport driver. If the miniport driver does not have a MOF resource attached, it should set MofResourceName to NULL.

Return value

HwStorWmiQueryReginfo returns SRB_STATUS_PENDING if the request is pending, or a nonzero SRB status value if the request was completed. The SRB status value returned by this routine is the same as what was passed in to ScsiPortWmiPostProcess.

Remarks

This routine is identical in both definition and function to its SCSI port equivalent, HwScsiWmiQueryReginfo.

When a miniport driver receives an SRB in which the Function member is set to SRB_FUNCTION_WMI, it calls ScsiPortWmiDispatchFunction with a pointer to an initialized SCSI_WMILIB_CONTEXT structure and MinorFunction set to Srb->WmiSubFunction. If MinorFunction indicates a request for registration information, the SCSI port driver calls the miniport driver's HwStorWmiQueryReginfo routine.

The miniport driver provides new or updated registration information about individual blocks, or indicates blocks to remove, in the SCSI_WMILIB_CONTEXT structure it passes to ScsiPortWmiDispatchFunction. The miniport driver's HwStorWmiQueryReginfo routine supplies a pointer to its MOF resource name.

The miniport driver must not pend or block the SRB. The miniport driver must not call ScsiPortWmiPostProcess or StorPortNotification from its HwStorWmiQueryReginfo routine.

Requirements

Header

Storport.h (include Storport.h)

See also

HwScsiWmiQueryReginfo
SCSI_WMILIB_CONTEXT
SCSIWMI_REQUEST_CONTEXT
ScsiPortWmiDispatchFunction

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft