Função StorPortCancelDpc (storport.h)
StorPortCancelDpc tenta cancelar a execução de uma DPC (chamada de procedimento adiado) do StorPort.
Sintaxe
ULONG StorPortCancelDpc(
PVOID HwDeviceExtension,
PSTOR_DPC Dpc,
BOOLEAN *ReturnValue
);
Parâmetros
HwDeviceExtension
Ponteiro para a extensão do dispositivo de hardware para o HBA (adaptador do barramento de host).
Dpc
Ponteiro para o objeto DPC STOR_DPC a ser cancelado.
ReturnValue
Ponteiro para um BOOLEAN no qual essa função retornará um dos valores a seguir.
| Valor retornado | Descrição |
|---|---|
| VERDADEIRO | O Dpc especificado foi removido com êxito da fila DPC do sistema. |
| FALSO | O Dpc especificado não foi removido da fila DPC do sistema. |
Valor de retorno
Essa função retorna um dos seguintes códigos de status.
| Código de retorno | Descrição |
|---|---|
| STOR_STATUS_INVALID_PARAMETER | Dpc ou ReturnValue são NULL. |
|
Essa função não é implementada no sistema operacional ativo. |
| STOR_STATUS_SUCCESS | Essa função foi concluída com êxito. Use o valor retornado em ReturnValue para determinar se o Dpc foi removido da fila. |
Observações
Se o DPC do StorPort especificado estiver na fila DPC, StorPortCancelDpc o removerá da fila, cancelando uma chamada para a rotina de DPC associada. Se não estiver na fila, ele estava em execução ou terminou a execução e, portanto, não pôde ser removido.
Essa rotina é implementada usando definições de função embutida, para que os drivers de miniporto que a usam não precisem vincular a bibliotecas dependentes da versão do sistema operacional. Os drivers de miniport podem usar essa rotina sem sacrificar a compatibilidade com versões do sistema operacional que não dão suporte a DPCs em drivers de miniporto de armazenamento.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | storport.h |