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

El método WaitForTC espera a que se complete el recuento de terminales de transferencia de DMA o agota el tiempo de espera si el intervalo de tiempo de espera especificado expira primero.

Sintaxis

NTSTATUS WaitForTC(
  ULONG Timeout
);

Parámetros

Timeout

Especifica el intervalo de tiempo de espera en microsegundos. Este intervalo es el período de tiempo que el método espera a que se complete la transferencia antes de que se agote el tiempo de espera. El intervalo de tiempo de espera especificado se redondea hacia abajo hasta el incremento de diez microsegundos más próximo.

Valor devuelto

El método WaitForTC devuelve NTSTATUS. Devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, el método devuelve un código de error adecuado.

Comentarios

Nota

Microsoft admite un entorno diverso e inclusivo. Este artículo contiene referencias a la terminología que la guía de estilo de Microsoft para la comunicación sin sesgo reconoce como exclusionary. La palabra o frase se usa en este artículo para la coherencia porque aparece actualmente en el software. Cuando el software se actualice para quitar el idioma, este artículo se actualizará para que esté en alineación.

Solo se debe llamar a este método en dos situaciones:

1. Después de enviar una solicitud al hardware para que se detenga, el controlador de miniporta llama a WaitForTC para esperar a que el DMA se complete antes de continuar con la ejecución.

2. En el caso del hardware DMA que no se inicializa automáticamente, el controlador de minipuerto puede llamar a WaitForTC en cualquier momento para esperar hasta que se complete una transferencia DMA.

Dado que este método simplemente espera hasta que la transferencia de DMA se complete o agote el tiempo de espera, los autores de llamadas de WaitForTC deben ejecutarse en irQL PASSIVE_LEVEL.

Requisitos

Requisito	Valor
Header	portcls.h
IRQL	PASSIVE_LEVEL (consulte la sección Comentarios).

Consulte también

Interfaz IDmaChannelSlave