Função ScsiPortFreeDeviceBase (srb.h)
A rotina ScsiPortFreeDeviceBase libera uma variedade de endereços de E/S ou espaço de memória do dispositivo 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 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 do HBA. Essa área está disponível para o driver de miniporto no membro DeviceExtension-HwDeviceExtension> 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.
Retornar valor
Nenhum
Comentários
Se a rotina HwScsiFindAdapter de um driver de miniport determina 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 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 |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | srb.h (inclua Miniport.h, Scsi.h) |
| Biblioteca | Scsiport.lib |