Função StorPortGetScatterGatherList (storport.h)

Artigo
03/05/2024

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 miniport. 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.

Retornar valor

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

Comentários

Essa rotina é fornecida com a biblioteca de driver do Storport. Não há 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 miniporte não precisa liberar a memória para a lista de dispersão/coleta que StorPortGetScatterGatherList retorna.

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

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.