Função StorPortGetSystemAddress (storport.h)

Artigo
02/07/2025

A rotina StorPortGetSystemAddress retorna um endereço virtual no espaço do sistema para o buffer de dados do SRB (bloco de solicitação SCSI) especificado.

Sintaxe

ULONG StorPortGetSystemAddress(
  [in]  PVOID               HwDeviceExtension,
  [in]  PSCSI_REQUEST_BLOCK Srb,
  [out] PVOID               *SystemAddress
);

Parâmetros

[in] HwDeviceExtension

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

[in] Srb

Um ponteiro para uma estrutura SCSI_REQUEST_BLOCK.

[out] SystemAddress

Um ponteiro para receber o endereço virtual do buffer de dados.

Valor de retorno

StorPortGetSystemAddress retorna um dos seguintes códigos 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 o endereço do sistema foi obtido com êxito.
STOR_STATUS_INVALID_PARAMETER	Esse código de status é causado por uma das seguintes condições: O SRB não tem um buffer de dados associado. O ponteiro para receber o endereço virtual é NULL.
STOR_STATUS_INVALID_IRQL	A chamada foi feita em um IRQL inválido.
STOR_STATUS_INSUFFICIENT_RESOURCES	Falha na tentativa de mapear o buffer de dados para o espaço do sistema.

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
de cliente com suporte mínimo	Essa rotina está disponível a partir do Windows Server 2003 com SP2.
da Plataforma de Destino	Universal
cabeçalho	storport.h (inclua Storport.h)
IRQL	<=DISPATCH_LEVEL
regras de conformidade de DDI	StorPortIrql(storport)

Consulte também

SCSI_REQUEST_BLOCK

STORAGE_REQUEST_BLOCK

Compartilhar via