PSCSIWMI_QUERY_REGINFO función de devolución de llamada (scsiwmi.h)

Artículo
02/29/2024

Se llama a la rutina HwScsiWmiQueryReginfo de un controlador de miniporte para obtener información sobre los bloques de datos y eventos que se registrarán en nombre del controlador de minipuerto mediante el controlador de puerto SCSI. Esta rutina es necesaria.

Nota Los modelos del controlador de puerto SCSI y del controlador de miniporte SCSI pueden modificarse o no estar disponibles en el futuro. En su lugar, se recomienda usar el controlador Storport y los modelos de controlador de miniport storport .

Sintaxis

PSCSIWMI_QUERY_REGINFO PscsiwmiQueryReginfo;

UCHAR PscsiwmiQueryReginfo(
  [in]  PVOID DeviceContext,
  [in]  PSCSIWMI_REQUEST_CONTEXT RequestContext,
  [out] PWSTR *MofResourceName
)
{...}

Parámetros

[in] DeviceContext

Apunta al valor de contexto definido por el controlador miniport pasado a ScsiPortWmiDispatchFunction.

[in] RequestContext

Apunta a la estructura SCSIWMI_REQUEST_CONTEXT que el controlador de miniporte pasó a ScsiPortWmiDispatchFunction.

[out] MofResourceName

Apunta a una cadena Unicode terminada en null que indica el nombre del recurso MOF asociado al archivo de imagen binaria del controlador de miniport. Esta cadena se puede declarar como una constante en el controlador de minipuerto. Si el controlador de miniporte no tiene asociado un recurso MOF, debe establecer MofResourceName en NULL.

Valor devuelto

HwScsiWmiQueryReginfo siempre devuelve SRB_STATUS_SUCCESS.

Comentarios

Cuando un controlador de miniporte recibe un SRB en el que el miembro Function se establece en SRB_FUNCTION_WMI, llama a ScsiPortWmiDispatchFunction con un puntero a una estructura de SCSI_WMILIB_CONTEXT inicializada y MinorFunction establecida en Srb-WmiSubFunction>. Si MinorFunction indica una solicitud de información de registro, el controlador de puerto SCSI llama a la rutina HwScsiWmiQueryReginfo del controlador de miniporte.

El controlador de minipuerto proporciona información de registro nueva o actualizada sobre bloques individuales, o indica los bloques que se van a quitar, en la estructura SCSI_WMILIB_CONTEXT pasa a ScsiPortWmiDispatchFunction. La rutina HwScsiWmiQueryReginfo del controlador miniport proporciona un puntero a su nombre de recurso MOF.

El controlador de minipuerto no debe bloquear ni bloquear el SRB. El controlador de miniport no debe llamar a ScsiPortWmiPostProcess o ScsiPortNotification desde su rutina HwScsiWmiQueryReginfo .