structure SERIAL_TIMEOUTS (ntddser.h)
La structure SERIAL_TIMEOUTS spécifie les paramètres de délai d’attente pour les opérations de lecture et d’écriture par le port série.
Syntaxe
typedef struct _SERIAL_TIMEOUTS {
ULONG ReadIntervalTimeout;
ULONG ReadTotalTimeoutMultiplier;
ULONG ReadTotalTimeoutConstant;
ULONG WriteTotalTimeoutMultiplier;
ULONG WriteTotalTimeoutConstant;
} SERIAL_TIMEOUTS, *PSERIAL_TIMEOUTS;
Membres
ReadIntervalTimeout
Durée maximale, en millisecondes, autorisée entre deux octets consécutifs dans une opération de lecture. Opération de lecture qui dépasse ce délai maximal d’attente. Cette valeur maximale ne s’applique pas à l’intervalle de temps qui précède la lecture du premier octet. La valeur zéro indique que les délais d’attente d’intervalle ne sont pas utilisés. Pour plus d’informations, consultez Remarques.
ReadTotalTimeoutMultiplier
Durée maximale, en millisecondes, autorisée par octet dans une opération de lecture. Opération de lecture qui dépasse ce délai maximal d’attente. Pour plus d’informations, consultez Remarques.
ReadTotalTimeoutConstant
Durée maximale de temps supplémentaire, en millisecondes, autorisée par opération de lecture. Opération de lecture qui dépasse ce délai maximal d’attente. Pour plus d’informations, consultez Remarques.
WriteTotalTimeoutMultiplier
Durée totale maximale, en millisecondes, autorisée par octet dans une opération d’écriture. Opération d’écriture qui dépasse ce délai maximal d’attente. Pour plus d’informations, consultez Remarques.
WriteTotalTimeoutConstant
Durée maximale, en millisecondes, autorisée par opération d’écriture. Opération d’écriture qui dépasse ce délai maximal d’attente. Pour plus d’informations, consultez Remarques.
Remarques
La structure SERIAL_TIMEOUTS est utilisée par les demandes de contrôle d’E/S IOCTL_SERIAL_SET_TIMEOUTS et IOCTL_SERIAL_GET_TIMEOUTS. Une demande de contrôle d’E/S IOCTL_SERIAL_SET_TIMEOUTS utilise cette structure pour spécifier un ensemble de paramètres de délai d’attente pour le port série à utiliser pour les opérations de lecture et d’écriture. Une demande de contrôle d’E/S IOCTL_SERIAL_GET_TIMEOUTS utilise cette structure pour récupérer les paramètres de délai d’attente qui ont été définis par la demande de IOCTL_SERIAL_SET_TIMEOUTS précédente.
Une demande de lecture ou d’écriture se termine correctement lorsque le nombre spécifié d’octets est transféré ou que l’opération de lecture ou d’écriture demandée expire. La requête retourne le code d’état STATUS_SUCCESS pour indiquer que le nombre spécifié d’octets a été transféré. La requête retourne le code d’état STATUS_TIMEOUT pour indiquer que l’opération a expiré.
Si une requête IRP_MJ_READ spécifie une opération de lecture qui est Ntₒtₐl octets de longueur, la durée maximale, Tmₐₓ, que le port série permet à l’opération de se terminer est calculé comme suit :
Tmₐₓ = Ntₒtₐl * ReadTotalTimeoutMultiplier + ReadTotalTimeoutConstant
Une demande de lecture qui dépasse ce nombre maximal se termine lorsque le délai d’attente se produit et retourne le code d’état STATUS_TIMEOUT. L'Informations champ du bloc d’état d’E/S indique le nombre d’octets lus correctement avant l’expiration du délai d’attente.
Si une requête IRP_MJ_WRITE spécifie une opération d’écriture qui est Ntₒtₐl octets de longueur, la durée maximale, Tmₐₓ, que le port série permet à l’opération de se terminer est calculé comme suit :
Tmₐₓ = Ntₒtₐl * WriteTotalTimeoutMultiplier + WriteTotalTimeoutConstant
Une demande d’écriture qui dépasse ce nombre maximal se termine lorsque le délai d’attente se produit et retourne le code d’état STATUS_TIMEOUT. L'Informations champ du bloc d’état d’E/S indique le nombre d’octets écrits correctement avant l’expiration du délai d’attente.
La durée maximale, Tmₐₓ, autorisée pour l’exécution d’une opération de lecture ou d’écriture, est toujours mesurée à partir du moment où le port série démarre l’opération demandée, et non à partir du moment où le client envoie la demande.
Si ReadIntervalTimeout, ReadTotalTimeoutMultiplieret ReadTotalTimeoutConstant sont toutes nulles, les opérations de lecture n’expirent jamais. Si writeTotalTimeoutMultiplier et WriteTotalTimeoutConstant sont à la fois zéro, les opérations d’écriture n’expirent jamais.
Si ReadIntervalTimeout est égal à zéro, il n’existe aucun intervalle maximal entre les octets consécutifs dans les opérations de lecture et les délais d’attente sont basés uniquement sur les membres ReadTotalTimeoutMultiplier et ReadTotalTimeoutConstant membres.
Si les deux ReadTotalTimeoutMultiplier et ReadTotalTimeoutConstant sont zéro, et ReadIntervalTimeout est inférieur à MAXULONG et supérieur à zéro, une opération de lecture expire uniquement si l’intervalle entre une paire d’octets reçus consécutivement dépasse ReadIntervalTimeout. Si ces trois valeurs de délai d’attente sont utilisées et que la mémoire tampon d’entrée du port série est vide lorsqu’une demande de lecture est envoyée au port, cette requête n’expire jamais jusqu’à ce que le port reçoive au moins un octet de nouvelles données.
Si readIntervalTimeout est défini sur MAXULONG, et les deux ReadTotalTimeoutConstant et ReadTotalTimeoutMultiplier sont zéro, une demande de lecture se termine immédiatement avec les octets qui ont déjà été reçus, même si aucun octet n’a été reçu. Dans ce cas, la demande de lecture retourne le code d’état STATUS_SUCCESS.
Si les deux ReadIntervalTimeout et ReadTotalTimeoutMultiplier sont définis sur MAXULONG, et ReadTotalTimeoutConstant est défini sur une valeur supérieure à zéro et inférieure à MAXULONG, une demande de lecture se comporte comme suit :
- S’il existe des octets dans la mémoire tampon d’entrée du port série, la demande de lecture se termine immédiatement avec les octets qui se trouvent dans la mémoire tampon et retourne le code d’état STATUS_SUCCESS.
- S’il n’y a pas d’octets dans la mémoire tampon d’entrée, le port série attend qu’un octet arrive, puis termine immédiatement la demande de lecture avec l’un des octets de données et retourne le code d’état STATUS_SUCCESS.
- Si aucun octet n’arrive dans le délai spécifié par ReadTotalTimeoutConstant, la demande de lecture expire, définit le champ Information du bloc d’état d’E/S sur zéro et retourne le code d’état STATUS_TIMEOUT.
Un délai d’expiration d’intervalle de lecture peut être utilisé pour détecter la fin d’un flux de données entrant lorsque la longueur du flux de données n’est pas connue à l’avance. Si une demande de lecture utilise cette technique, un code d’état d’achèvement STATUS_TIMEOUT signifie généralement que la demande s’est terminée correctement.
Un délai d’expiration d’intervalle de lecture se produit lorsque l’intervalle entre les octets entrants dépasse la valeur ReadIntervalTimeout. Les intervalles de délai d’attente sont mesurés par rapport à l’horloge système, et la précision de la mesure de délai d’attente est limitée par la granularité de l’horloge système. Par conséquent, un délai d’attente peut se produire entre une horloge système et une graduation plus tard que l’intervalle de délai d’attente spécifié, selon l’endroit où exactement les heures de début et de fin de cet intervalle tombent entre les cycles d’horloge système. Les délais d’attente peuvent se produire même plus tard si le traitement des interruptions d’horloge système est retardé par le traitement des interruptions pour d’autres appareils. Si un intervalle de délai d’attente spécifié est proche ou inférieur à la période entre les cycles d’horloge système, le délai d’attente peut se produire immédiatement, sans délai.
Un moyen possible de mesurer plus précisément les intervalles de délai d’attente plus petits consiste à réduire le temps entre les cycles d’horloge système, mais cela est susceptible d’augmenter la consommation d’énergie. En outre, la réduction de la période d’horloge système peut ne pas atteindre de manière fiable une granularité plus fine de l’horloge système, sauf si le traitement lié à l’interruption par les différents pilotes de la plateforme peut être garanti de ne pas retarder le traitement des interruptions d’horloge système.
La structure SERIAL_TIMEOUTS est similaire à la structure COMMTIMEOUTS, utilisée par les fonctions SetCommTimeouts et GetCommTimeouts.
Pour plus d’informations, consultez définition des délais d’expiration de lecture et d’écriture pour un appareil série.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Prise en charge à partir de Windows 2000. |
| d’en-tête | ntddser.h |