Função StorPortDeviceBusy (storport.h)

Artigo
02/07/2025

A rotina StorPortDeviceBusy notifica o driver de porta de que a unidade lógica especificada está ocupada no momento, tratando solicitações pendentes.

Sintaxe

STORPORT_API BOOLEAN StorPortDeviceBusy(
  [in] PVOID HwDeviceExtension,
  [in] UCHAR PathId,
  [in] UCHAR TargetId,
  [in] UCHAR Lun,
  [in] ULONG RequestsToComplete
);

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 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 para o HBA. Essa área está disponível para o driver de miniporto imediatamente após o driver de miniporto chamar StorPortInitialize. O driver de porta libera essa memória quando remove o dispositivo.

[in] PathId

Identifica o barramento SCSI.

[in] TargetId

Identifica o controlador de destino ou o dispositivo nos ônibus determinados.

[in] Lun

Identifica a unidade lógica para o determinado controlador de destino ou dispositivo.

[in] RequestsToComplete

Indica o número de solicitações que a unidade lógica deve concluir antes de retomar as solicitações de E/S para o driver de miniporto. Se RequestsToComplete for maior do que o número de solicitações pendentes no momento, o driver Storport concluirá todas as solicitações pendentes para a unidade lógica antes de retomar as solicitações.

Valor de retorno

StorPortDeviceBusy retornará verdadeiro se o driver de miniporto tiver êxito em notificar o driver de porta, false se não.

Observações

Nenhum log de erros é gerado quando um dispositivo está ocupado.

O driver de porta não emitirá novas solicitações para a unidade lógica até que a fila da unidade lógica tenha sido drenada para um nível suficiente em que o processamento possa continuar.

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
cabeçalho	storport.h (inclua Storport.h)
biblioteca	Storport.lib

Consulte também

StorPortBusy

StorPortReady

Compartilhar via