Partager via


Paramètres du Registre pour un appareil série Plug-and-Play

Cette rubrique décrit les paramètres de Registre que serial utilise comme pilote de fonction pour un périphérique série Plug-and-Play. La série utilise également ces paramètres comme pilote de filtre de périphérique de niveau inférieur pour un appareil qui nécessite une interface compatible UART 16550.

Serial interroge ces valeurs d’entrée de Registre lorsqu’il ajoute l’appareil. Si aucune valeur d’entrée spécifique à l’appareil n’est présente, serial utilise une valeur de service série.

Les paramètres de Registre suivants se trouvent sous la clé de Registre Plug-and-Play pour un appareil.

PortName (REG_SZ)
Spécifie le nom de l’appareil. Le nom d’un appareil est généralement COM<n>,<n> est un numéro de port COM que le programme d’installation obtient à partir de la base de données de ports COM. Toutefois, l’appareil peut être défini sur n’importe quelle chaîne non NULL. Si l’appareil est configuré en tant que port COM, Serial utilise le nom de port pour créer un nom de lien symbolique pour l’appareil. La valeur par défaut de PortName est une chaîne vide.

Identificateur (REG_SZ)
Spécifie le nom de l’appareil. La prise en charge d’une valeur d’entrée Identificateur est fournie pour la compatibilité avec certains appareils PCMCIA hérités. L’utilisation de l’identificateur est obsolète et ne doit pas être utilisée avec les pilotes Microsoft Windows 2000 et ultérieur. Pour obtenir une description, consultez la valeur d’entrée PortName .

MultiportDevice (REG_DWORD)
Spécifie un indicateur booléen qui indique si un port série est un appareil sur un appareil multiport. Si MultiportDevice est 0x00000000, le port série est un appareil autonome ; sinon, le port série se trouve sur un appareil multiport. La valeur par défaut de MultiportDevice est 0x00000000.

PortIndex (REG_DWORD)
Spécifie le numéro d’index d’un port série sur un appareil multiport. La valeur d’entrée Indexé spécifie si un port est bitmap ou indexé. La valeur par défaut de PortIndex est 0x00000000.

ClockRate (REG_DWORD)
Spécifie la fréquence d’horloge UART. La valeur par défaut de ClockRate est 1 843 200 Hertz.

Indexé (REG_DWORD)
Spécifie un indicateur booléen qui indique si un port sur un appareil multiport est bitmap ouindexé. Si Indexed est différent de zéro, le port est indexé ; sinon, le port est bitmap. Indexed est utilisé conjointement avec la valeur d’entrée PortIndex . La valeur par défaut de Indexed est 0x00000000.

DisablePort (REG_DWORD)
Indicateur booléen qui spécifie s’il faut désactiver l’appareil. Si DisablePort n’est pas zéro, Serial désactive l’appareil ; sinon, l’appareil est activé. L’utilisation de la valeur d’entrée DisablePort est obsolète et ne doit pas être utilisée avec les pilotes Windows 2000 et versions ultérieures. Windows 2000 fournit une méthode manuelle générique via l’interface utilisateur graphique de Gestionnaire de périphériques pour activer et désactiver des appareils. La valeur par défaut de DisablePort est 0x00000000. Notez que le fait de marquer un appareil comme désactivé ne signifie pas qu’il n’existe pas. La série tente toujours de détecter la présence d’un appareil désactivé. Si l’appareil est spécifié comme désactivé, serial retourne STATUS_NO_SUCH_DEVICE en réponse à une demande de IRP_MN_START_DEVICE . Après l’échec de la demande de démarrage, le gestionnaire de Plug-and-Play envoie une demande de suppression.

ForceFifoEnable (REG_DWORD)
Spécifie un indicateur booléen qui indique s’il faut forcer Serial à utiliser des IFF. Si ForceFifoEnable n’est pas zéro, les fiFO sont utilisées, que Serial puisse ou non détecter la présence de fifoOs. Dans le cas contraire, les fiFOs ne sont utilisés que si serial peut les détecter. La valeur par défaut de ForceFifoEnable est la valeur définie pour le service Série. (La valeur par défaut du service série est 0x00000001.)

RxFIFO (REG_DWORD)
Spécifie le nombre d’octets dans le FIFO de réception qui déclenche une interruption de port série. Pour connaître les valeurs valides, consultez les constantes définies dans le fichier d’en-tête Serial.h dans l’exemple de pilote série sur GitHub. La valeur par défaut de RxFIFO est la valeur définie pour le service série. (La valeur par défaut du service série est de huit octets.)

TxFIFO (REG_DWORD)
Spécifie le nombre d’octets dans le FIFO de transmission qui déclenche une interruption d’appareil en série. Pour connaître les valeurs valides, consultez les constantes définies dans le fichier d’en-tête Serial.h dans l’exemple de pilote série sur GitHub. La valeur par défaut de TxFIFO est la valeur définie pour le service série. (La valeur par défaut du service série est de quatorze octets.)

MaskInverted (REG_DWORD)
Spécifie un indicateur booléen qui indique si le matériel de périphérique série inverse le contenu de l’interruption status inscrire. Si MaskInverted est différent de zéro, l’interruption status registre est inversée ; sinon, l’interruption status registre n’est pas inversée. La valeur par défaut de MaskInverted est 0x00000000.

SerialSkipExternalNaming (REG_DWORD)
Spécifie un indicateur booléen qui indique si Serial configure l’appareil en tant que port COM. Si SerialSkipExternalNaming est défini sur 0x00000000, Serial configure l’appareil en tant que port COM ; sinon, serial ne configure pas l’appareil en tant que port COM. La valeur par défaut de SerialSkipExternalNaming est 0x00000000. Pour plus d’informations sur la façon dont serial configure un appareil en tant que port COM, consultez Affectation de noms externes de ports COM.

SerialRelinquishPowerPolicy (REG_DWORD)
Spécifie un indicateur booléen qui indique si Serial est le propriétaire de la stratégie d’alimentation pour une pile d’appareils série. Si SerialRelinquishPowerPolicy est égal à zéro, Serial est le propriétaire de la stratégie d’alimentation ; sinon, Serial n’est pas le propriétaire de la stratégie d’alimentation. La valeur par défaut de SerialRelinquishPowerPolicy est 0x00000000.

Partager l’interruption système (REG_DWORD)
Indicateur booléen qui spécifie s’il faut autoriser le système à partager l’interruption que l’appareil utilise. Si l’interruption du système de partage est différente de zéro, l’interruption peut être partagée ; sinon, l’interruption ne peut pas être partagée. La valeur par défaut de Share System Interrupt est la valeur définie pour la valeur d’entrée PermitShare pour le service série. (La valeur de service par défaut pour PermitShare est 0x00000000.)

SerialIoResourcesIndex (REG_DWORD)
Spécifie l’index du descripteur de ressources partiel utilisé par Serial pour déterminer les adresses d’E/S du registre série défini pour l’appareil. La valeur par défaut de SerialIoResourceIndex est 0x00000000.