Função StorPortGetScatterGatherList (storport.h)
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.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Cabeçalho | storport.h (inclua Storport.h) |
| Biblioteca | Storport.lib |