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

Artigo
02/07/2025

A rotina de HwScsiWmiExecuteMethod de um driver de miniport é chamada para executar um método associado a um bloco de dados. Essa rotina é opcional.

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_EXECUTE_METHOD PscsiwmiExecuteMethod;

BOOLEAN PscsiwmiExecuteMethod(
  [in]      PVOID DeviceContext,
  [in]      PSCSIWMI_REQUEST_CONTEXT RequestContext,
  [in]      ULONG GuidIndex,
  [in]      ULONG InstanceIndex,
  [in]      ULONG MethodId,
  [in]      ULONG InBufferSize,
  [in]      ULONG OutBufferSize,
  [in, out] PUCHAR Buffer
)
{...}

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.

[in] GuidIndex

Especifica o bloco de dados por seu índice na lista de GUIDs na estrutura SCSI_WMILIB_CONTEXT que o driver de miniporto passou para ScsiPortWmiDispatchFunction.

[in] InstanceIndex

Se o bloco especificado por guidIndex tiver várias instâncias, InstanceIndex especificar a instância.

[in] MethodId

Especifica a ID do método a ser executado. O driver de miniporto define a ID do método como um item em um bloco de dados.

[in] InBufferSize

Indica o tamanho em bytes dos dados de entrada. Se não houver dados de entrada, InBufferSize será zero.

[in] OutBufferSize

Indica o número de bytes disponíveis no buffer para dados de saída.

[in, out] Buffer

Aponta para um buffer que contém os dados de entrada e recebe os dados de saída, se houver, do método. Se o buffer for muito pequeno para receber toda a saída, o driver de miniporto chamará ScsiPortWmiPostProcess com SRB_STATUS_DATA_OVERRUN e o tamanho necessário.

Valor de retorno

HwScsiWmiExecuteMethod retornará SRB_STATUS_PENDING se a solicitação estiver pendente ou um valor de status SRB diferente de zero se a solicitação tiver sido concluída. O valor de status SRB retornado por essa rotina é o mesmo que foi passado para ScsiPortWmiPostProcess. Embora o tipo de dados de valor retornado seja BOOLEAN, o HwScsiWmiExecuteMethod rotina realmente retorna um valor de status SRB.

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. O driver de porta SCSI chama a rotina de do driver de miniporto HwScsiWmiExecuteMethod se minorfunction indicar uma solicitação para executar um método.

Se um driver de miniporto não implementar uma rotina de HwScsiWmiExecuteMethod, ele deverá definir ExecuteWmiMethod para NULL no SCSI_WMILIB_CONTEXT o driver de miniporto passa para ScsiPortWmiDispatchFunction. Nesse caso, o driver de porta retorna SRB_STATUS_ERROR ao chamador.

Se o método gerar saída, o driver de miniporto deverá verificar o tamanho do buffer de saída em OutBufferSize antes de executar qualquer operação que possa ter efeitos colaterais ou que não deve ser executada duas vezes. Por exemplo, se um método retornar os valores de um grupo de contadores e redefinir os contadores, o driver de miniporto deverá verificar o tamanho do buffer antes de redefinir os contadores. Isso garante que o driver de porta possa reenviar a solicitação com segurança com um buffer maior. Se o buffer for muito pequeno, o driver de miniporto deverá chamar ScsiPortWmiPostProcess com SRB_STATUS_DATA_OVERRUN e o tamanho do buffer de saída necessário para atender à solicitação.

O driver de miniporto executa o método e grava a saída, se houver, no buffer. Antes de retornar de HwScsiWmiExecuteMethod, o driver de miniporto chama ScsiPortWmiPostProcess com um valor de SrbStatus apropriado e o número de bytes usados no buffer de saída.