Função StorPortGetScatterGatherList (storport.h)

2025-02-07

A rotina StorPortGetScatterGatherList recupera a lista de dispersão/coleta associada para o SRB (bloco de solicitação SCSI) especificado.

Sintaxe

STORPORT_API PSTOR_SCATTER_GATHER_LIST StorPortGetScatterGatherList(
  [in] PVOID               HwDeviceExtension,
  [in] PSCSI_REQUEST_BLOCK Srb
);

Parâmetros

[in] HwDeviceExtension

Um ponteiro para a extensão do dispositivo de hardware. Essa é uma área de armazenamento por HBA que o driver de porta aloca e inicializa em nome do driver de miniporto. Os drivers de miniporto geralmente armazenam informações específicas do HBA nessa extensão, como o estado do HBA e os intervalos de acesso mapeados para o HBA. Essa área está disponível para o miniporto imediatamente após o driver de miniporto chamar StorPortInitialize. O driver de porta libera essa memória quando remove o dispositivo.

[in] Srb

Ponteiro para o SRB para o qual a lista de coleta de dispersão deve ser construída.

Valor de retorno

StorPortGetScatterGatherList retorna um ponteiro para a lista de dispersão/coleta.

Observações

Essa rotina é fornecida com a biblioteca de driver do Storport. Não há nenhuma rotina paralela fornecida na biblioteca de portas SCSI.

O ponteiro para a lista de dispersão/coleta retornado é válido somente até que o SRB seja concluído.

O driver de miniporto não precisa liberar a memória para a lista de dispersão/coleta que StorPortGetScatterGatherList retorna.

O driver de miniporto não deve modificar a lista de dispersão/coleta.

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.