Função StorPortGetStartIoPerfParams (storport.h)

  • Artigo

A rotina StorPortGetStartIoPerfParams coloca os parâmetros de desempenho para uma determinada solicitação de E/S em uma estrutura STARTIO_PERFORMANCE_PARAMETERS .

Sintaxe

ULONG StorPortGetStartIoPerfParams(
  [in]      PVOID                           HwDeviceExtension,
  [in]      PSCSI_REQUEST_BLOCK             Srb,
  [in, out] PSTARTIO_PERFORMANCE_PARAMETERS StartIoPerfParams
);

Parâmetros

[in] HwDeviceExtension

Um ponteiro para a extensão do dispositivo de hardware para o HBA (adaptador de barramento de host).

[in] Srb

O ponteiro SRB que foi passado para a rotina HwStorStartIo que foi fornecida pelo driver de miniporto. Esse parâmetro não deve ser NULL.

[in, out] StartIoPerfParams

Um ponteiro para uma estrutura STARTIO_PERFORMANCE_PARAMETERS que o driver de miniporto fornece. O driver de miniporte precisa definir apenas o tamanho da estrutura alocada, pois o Storport definirá os outros membros. Esse parâmetro não deve ser NULL.

Retornar valor

StorPortGetStartIoPerfParams retorna um dos seguintes valores de status:

Código de retorno Descrição
STOR_STATUS_NOT_IMPLEMENTED
 Essa função não é implementada no sistema operacional ativo.
STOR_STATUS_SUCCESS
 Indica que os parâmetros de desempenho foram armazenados em StartIoPerfParams.
STOR_STATUS_INVALID_PARAMETER
 O parâmetro Srb ou o parâmetro StartIoPerfParams é NULL.

-ou-

O parâmetro HwDeviceExtension é NULL ou não é válido.

-ou-

O parâmetro Srb não está apontando para um SRB enviado pelo Storport

-ou-

A estrutura apontada por StartIoPerfParams não é válida porque o valor de seu membro Size indica que a estrutura é muito pequena para conter os dados retornados.

Comentários

A partir de Windows 8, o parâmetro Srb pode apontar para SCSI_REQUEST_BLOCK ou STORAGE_REQUEST_BLOCK. Se o identificador de função no campo Função de Srb for SRB_FUNCTION_STORAGE_REQUEST_BLOCK, o SRB será um STORAGE_REQUEST_BLOCK estrutura de solicitação.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Cabeçalho storport.h (inclua Storport.h)

Confira também

SCSI_REQUEST_BLOCK

STARTIO_PERFORMANCE_PARAMETERS

STORAGE_REQUEST_BLOCK