Função ScsiPortFreeDeviceBase (srb.h)
A rotina ScsiPortFreeDeviceBase libera uma variedade de endereços de E/S do dispositivo ou de espaço de memória mapeados anteriormente para o espaço de endereço do sistema com ScsiPortGetDeviceBase.
Sintaxe
SCSIPORT_API VOID ScsiPortFreeDeviceBase(
[in] PVOID HwDeviceExtension,
[in] PVOID MappedAddress
);
Parâmetros
[in] HwDeviceExtension
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 do HBA. Essa área está disponível para o driver de miniporto no DeviceExtension->HwDeviceExtension membro do objeto de dispositivo do HBA imediatamente após o driver de miniporto chamar ScsiPortInitialize. O driver de porta libera essa memória quando remove o dispositivo.
[in] MappedAddress
Ponteiro para o endereço base do intervalo a ser liberado. Esse endereço deve ser o mesmo retornado por ScsiPortGetDeviceBase.
Valor de retorno
Nenhum
Observações
Se o HwScsiFindAdapter de um driver de miniporto rotina determinará que o driver não precisa de um endereço base mapeado específico para um adaptador, ele deve liberar o mapeamento chamando essa rotina. Por exemplo, quando um driver de miniporto determina que não há HBAs com suporte em um ônibus de E/S específico, ele deve chamar ScsiPortFreeDeviceBase com cada endereço mapeado retornado por ScsiPortGetDeviceBase, se alguma chamada para essa rotina foi feita.
ScsiPortFreeDeviceBase só pode ser chamado da rotina de HwScsiFindAdapter do driver de miniport. Chamadas de outras rotinas de driver de miniporto resultarão em falha do sistema ou operação incorreta para o chamador.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | srb.h (inclua Miniport.h, Scsi.h) |
| biblioteca | Scsiport.lib |