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 de barramento de host).
Dpc
Ponteiro para o STOR_DPC objeto DPC a ser cancelado.
ReturnValue
Ponteiro para um BOOLEAN no qual essa função retornará um dos valores a seguir.
| Valor Retornado | Descrição |
|---|---|
| TRUE | O Dpc especificado foi removido com êxito da fila DPC do sistema. |
| FALSE | O Dpc especificado não foi removido da fila DPC do sistema. |
Retornar valor
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. |
Comentários
Se o StorPort DPC especificado estiver na fila DPC, StorPortCancelDpc o removerá da fila, cancelando uma chamada para a rotina DPC associada. Se não estiver na fila, ele estava em execução ou tinha terminado a execução e, portanto, não pôde ser removido.
Essa rotina é implementada usando definições de função embutidas, para que os drivers de miniport que a usam não precisem vincular a bibliotecas que dependem 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 |