PSCSIWMI_QUERY_REGINFO função de retorno de chamada (scsiwmi.h)

Artigo
02/07/2025

Uma rotina de de HwScsiWmiQueryReginfo de um miniporto é chamada para obter informações sobre os blocos de dados e eventos a serem registrados em nome do driver de miniport pelo driver de porta SCSI. Essa rotina é necessária.

Observação o driver de porta SCSI e os modelos de driver de miniporto SCSI podem estar alterados ou indisponíveis no futuro. Em vez disso, recomendamos usar o de driver do Storport e miniporto storport modelos de driver.

Sintaxe

PSCSIWMI_QUERY_REGINFO PscsiwmiQueryReginfo;

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

Parâmetros

[in] DeviceContext

Aponta para o valor de contexto definido pelo driver do miniport passado para ScsiPortWmiDispatchFunction.

[in] RequestContext

Aponta para a estrutura SCSIWMI_REQUEST_CONTEXT que o driver de miniporto passou para ScsiPortWmiDispatchFunction.

[out] MofResourceName

Aponta para um cadeia de caracteres Unicode terminadanulo que indica o nome do recurso MOF anexado ao arquivo de imagem binária do driver de miniport. Essa cadeia de caracteres pode ser declarada como uma constante no driver de miniporto. Se o driver de miniport não tiver um recurso MOF anexado, ele deverá definir MofResourceName para NULL.

Valor de retorno

HwScsiWmiQueryReginfo sempre retorna SRB_STATUS_SUCCESS.

Observações

Quando um driver de miniporto recebe um SRB no qual o membro da Função está definido como SRB_FUNCTION_WMI, ele chama ScsiPortWmiDispatchFunction com um ponteiro para uma estrutura de SCSI_WMILIB_CONTEXT inicializada e MinorFunction definido como Srb->WmiSubFunction. Se MinorFunction indicar uma solicitação de informações de registro, o driver de porta SCSI chamará a rotina de HwScsiWmiQueryReginfo do driver de miniport.

O driver de miniporto fornece informações de registro novas ou atualizadas sobre blocos individuais ou indica blocos a serem removidos, na estrutura SCSI_WMILIB_CONTEXT que ele passa para ScsiPortWmiDispatchFunction. A rotina HwScsiWmiQueryReginfo do driver de miniporto fornece um ponteiro para o nome do recurso MOF.

O driver de miniporto não deve ser pendente ou bloquear o SRB. O driver de miniporto não deve chamar ScsiPortWmiPostProcess ou ScsiPortNotification de sua rotina de HwScsiWmiQueryReginfo.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	scsiwmi.h (inclua Scsiwmi.h)

Consulte também

SCSIWMI_REQUEST_CONTEXT

SCSI_WMILIB_CONTEXT

ScsiPortWmiDispatchFunction

Partilhar via