Método IDmaChannelSlave::WaitForTC (portcls.h)
El método WaitForTC espera a que el recuento de terminales de transferencia de DMA se complete o agote 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 cercano.
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.
Observaciones
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 sesgos reconoce como excluyente. La palabra o frase se usa en este artículo para la coherencia porque aparece actualmente en el software. Cuando el software se actualiza 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:
Después de enviar una solicitud al hardware para que se detenga, el controlador de miniporta llama a WaitForTC para esperar a que se complete la DMA antes de continuar la ejecución.
En el caso del hardware DMA que no se inicializa automáticamente, el controlador de miniporte 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 DMA se complete o agote el tiempo de espera, los autores de llamadas de WaitForTC deben ejecutarse en IRQL PASSIVE_LEVEL.
Requisitos
| Requisito | Valor |
|---|---|
| encabezado de | portcls.h |
| irQL | PASSIVE_LEVEL (consulte la sección Comentarios). |