Método IDmaChannelSlave::WaitForTC (portcls.h)
O método WaitForTC aguarda a conclusão da contagem de terminais de transferência de DMA ou atinge o tempo limite se o intervalo de tempo limite especificado expirar primeiro.
Sintaxe
NTSTATUS WaitForTC(
ULONG Timeout
);
Parâmetros
Timeout
Especifica o intervalo de tempo limite em microssegundos. Esse intervalo é o período de tempo que o método aguarda a conclusão da transferência antes de atingir o tempo limite. O intervalo de tempo limite especificado é arredondado para baixo para o incremento de dez microssegundos mais próximo.
Retornar valor
O método WaitForTC retorna NTSTATUS. Ele retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, o método retorna um código de erro apropriado.
Comentários
Observação
A Microsoft dá suporte a um ambiente diversificado e inclusivo. Este artigo contém referências à terminologia que o guia de estilo da Microsoft para comunicação sem preconceitos reconhece como excludente. A palavra ou frase é usada neste artigo para consistência porque ela aparece atualmente no software. Quando o software for atualizado para remover o idioma, este artigo será atualizado para estar em alinhamento.
Esse método deve ser chamado em apenas duas situações:
Depois de enviar uma solicitação para o hardware parar, o driver de miniporto chama WaitForTC para aguardar a conclusão do DMA antes de continuar a execução.
No caso do hardware de DMA que não é inicializado automaticamente, o driver de miniport pode chamar WaitForTC a qualquer momento para aguardar até que uma transferência de DMA seja concluída.
Como esse método simplesmente aguarda até a transferência de DMA ser concluída ou atingir o tempo limite, os chamadores de WaitForTC devem estar em execução no IRQL PASSIVE_LEVEL.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | portcls.h |
| IRQL | PASSIVE_LEVEL (consulte a seção Comentários.) |