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

  • Artigo

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

Nota O driver de porta SCSI e os modelos de driver de miniporta SCSI podem ser alterados ou indisponíveis no futuro. Em vez disso, recomendamos usar os modelos de driver storport e driver de miniporto Storport .
 

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 miniporto passado para ScsiPortWmiDispatchFunction.

[in] RequestContext

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

[out] MofResourceName

Aponta para uma cadeia de caracteres Unicode terminada em nulo 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 miniporta. Se o driver de miniporto não tiver um recurso MOF anexado, ele deverá definir MofResourceName como NULL.

Retornar valor

HwScsiWmiQueryReginfo sempre retorna SRB_STATUS_SUCCESS.

Comentários

Quando um driver de miniporto recebe um SRB no qual o membro function é 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 HwScsiWmiQueryReginfo do driver de miniport.

O driver de miniporta 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 miniport fornece um ponteiro para o nome do recurso MOF.

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

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho scsiwmi.h (inclua Scsiwmi.h)

Confira também

SCSIWMI_REQUEST_CONTEXT

SCSI_WMILIB_CONTEXT

ScsiPortWmiDispatchFunction