Share via

Método IDmaChannelSlave::WaitForTC (portcls.h)

  • Artigo

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:

  1. 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.

  2. 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.)

Confira também

Interface IDmaChannelSlave