Retire la première valeur de donnée disponible du buffer côté client associé à la connexion que vous avez définie dans connexion en entrée et renvoie les données.

Remarque La bufférisation côté client s'applique aussi à d'autres protocoles, comme opc et file. Toutefois, dans certains cas, ces serveurs peuvent perdre des données.


icon

Entrées/Sorties

  • cstr.png connexion en entrée —

    connexion en entrée identifie la source des données à lire.

    connection in peut être une chaîne décrivant l' url, un contrôle de variable partagée, un paramètre de référence d' identification de connexion issu d'une fonction DataSocket Open , ou un paramètre de sortie de connexion issu d'une fonction DataSocket Write .

  • cfxdt.png type (variant) —

    type (variant) spécifie le type des données que vous voulez lire et définit le type du terminal de sortie des données. Le type par défaut est variant, lequel peut être de n'importe quel type.

    Câblez un type de données à cette entrée pour définir le type de données en sortie. LabVIEW ignore la valeur des données en entrée.

  • ci32.png timeout en ms (10000) —

    timeout en ms spécifie le temps d'attente pour qu'une mise à jour de la valeur soit disponible dans le buffer de connexion.

    Cette fonction ignore cette entrée et n'attend pas si attendre une valeur mise à jour est FAUX et qu'une valeur initiale est arrivée. La valeur par défaut est 10 000 ms (10 secondes).

  • cerrcodeclst.png entrée d'erreur (pas d'erreur) —

    entrée d'erreur décrit les conditions d'erreur qui ont lieu avant l'exécution de ce nœud. Cette entrée fournit la fonctionnalité entrée d'erreur standard.

  • cbool.png attendre une valeur mise à jour (V) —

    Si attendre une valeur mise à jour est défini sur VRAI, la fonction attend une mise à jour de valeur.

    Si le buffer de connexion contient des données non traitées, la fonction renvoie immédiatement la valeur disponible suivante. Sinon, la fonction attend la mise à jour pendant la durée du timeout en ms. Si la mise à jour ne se produit pas au cours de la période de retard, la fonction renvoie la valeur actuelle et le résultat du timeout en ms est VRAI. Si attendre une valeur mise à jour est FAUX, la fonction renvoie la valeur suivante qui est disponible dans le buffer de connexion ou la dernière valeur lue si aucune donnée n'est disponible.

  • iu32.png état —

    état rapporte les mises en garde ou les erreurs d'un serveur PSP ou d'un contrôleur FieldPoint. Si le 31e bit est à 1, l' état indique une erreur. Sinon, état indique un code d'état.

  • iu64.png qualité —

    qualité représente la qualité des données lues à partir d'une variable partagée ou d'un élément de données NI-PSP (NI Publish-Subscribe Protocol). Utilisez la valeur de qualité pour obtenir des informations sur la mise au point d'un VI.

    La table suivante présente certaines des valeurs de qualité possibles.

    Numéro de bit Description
    1 Il se peut que la valeur de cette variable partagée ne soit pas la valeur la plus récente de la source de données.
    2 Échec du capteur.
    3 Réponse d'erreur générale de périphérique.
    4 Échec du serveur.
    5 Échec général de communication.
    6 Variable introuvable dans le moteur de variables partagées. Il se peut que le déploiement de cette variable ait échoué.
    7 La variable partagée n'a pas de valeur connue.
    8 La variable partagée est inactive.
    10 À limite inférieure
    11 À limite supérieure
    12 Constante.
    13 Capteur imprécis.
    14 Les limites de l'unité au format ingénieur ont été dépassées.
    15 Erreur OPC générique.
    16 Erreur mathématique.
    17 Échec du lien de communication.
    18 NI-PSP n'est pas encore connecté au serveur.
    19 La recherche DNS du serveur a échoué.
    20 Le serveur n'est pas accessible.
    21 La recherche de service a échoué pour le serveur
    22 La connexion au serveur a été interrompue.
    23 Le processus est introuvable ou ne répond pas.
    24 L'URL n'a pas pu être résolue pour cette variable partagée.
    25 Vous n'avez pas les droits de lecture pour la variable partagée.
    26 L'URL n'est pas valide pour cette variable partagée.
    30 Le point a une alarme active.
    31 Échec de l'abonnement.
    32 Un bit de qualité supérieur à 32 est défini, ou une erreur ou un état a été rapporté.
    33 Le buffer de lecture côté client de la variable partagée est plein.
    34 Le buffer de lecture côté client de la variable partagée a débordé.
    35 Le buffer d'écriture côté serveur de la variable partagée est plein.
    36 Le buffer d'écriture côté serveur de la variable partagée a débordé.
  • istr.png connexion en sortie —

    connexion en sortie est la source de données qui spécifie la connexion de données.

  • ifxdt.png données —

    données représente le résultat de la lecture. Si cette fonction atteint la limite de temps, données renvoie la dernière valeur lue par cette fonction. Si cette fonction atteint la limite de temps et qu'aucune donnée n'a été lue ou si le type de données est incompatible, données renvoie la valeur 0, vide ou une valeur équivalente.

  • ibool.png hors délai —

    hors délai renvoie VRAI si la fonction a dépassé la limite de temps (timeout) lors de l'attente d'une mise à jour ou d'une valeur initiale.

  • ierrcodeclst.png sortie d'erreur —

    sortie d'erreur contient des informations sur l'erreur. Cette sortie fournit la fonctionnalité sortie d'erreur standard.

  • iatrn.png horodatage —

    horodatage renvoie les données d'horodatage des variables partagées et des éléments de données NI-PSP (NI Publish-Subscribe Protocol).

    • Exemples

    Reportez-vous aux exemples de fichiers inclus avec LabVIEW suivants.

    • labview\examples\Data Communication\DataSocket\Simple DataSocket\Simple DataSocket.lvproj