Partilhar via


Função StorPortGetStartIoPerfParams (storport.h)

A rotina StorPortGetStartIoPerfParams coloca os parâmetros de desempenho para uma determinada solicitação de E/S em uma estrutura de 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 o HwStorStartIo rotina 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 miniporto precisa definir apenas o tamanho da estrutura alocada, pois Storport definirá os outros membros. Esse parâmetro não deve ser NULL.

Valor de retorno

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 no 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 tamanho indica que a estrutura é muito pequena para conter os dados retornados.

Observações

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

Requisitos

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

Consulte também

SCSI_REQUEST_BLOCK

STARTIO_PERFORMANCE_PARAMETERS

STORAGE_REQUEST_BLOCK