Lit les données du fichier .tdms spécifié de manière asynchrone, puis les stocke dans la mémoire d'un composant externe à LabVIEW. Utilisez l'entrée référence de données de cette fonction pour spécifier l'emplacement de la mémoire externe, tel qu'une région d'un buffer DMA appartenant à un driver de périphériques.


icon

Entrées/Sorties

  • cgnrn.png fichier tdms —

    tdms file spécifie un numéro de référence pour le fichier .tdms sur lequel l'opération doit être effectuée. Utilisez la fonction TDMS - Ouvrir (Avancée) pour ouvrir le refnum.

  • cdatavalref.png référence de données —

    data reference spécifie la référence de la valeur des données externes qui pointe vers la région d'une mémoire tampon externe dans laquelle vous souhaitez que LabVIEW stocke les données que cette fonction lit à partir du fichier .tdms . Cette entrée accepte une référence de valeur de données externe contenant un tableau 1D ou 2D d'entiers, de nombres à virgule flottante, de booléens ou d'horodatages. Si l'entrée désactiver la bufférisation ? de la fonction TDMS - Ouvrir (Avancée) est VRAI, la taille des données câblées à référence de données doit être un multiple de la taille de secteur.

  • 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 supprimer automatiquement la référence ? (V) —

    supprimer automatiquement la référence ? spécifie si vous voulez que LabVIEW supprime la référence de données automatiquement lorsque l'opération asynchrone est terminée. Lorsque la référence de données est supprimée, le propriétaire de la mémoire externe est informé que LabVIEW n'a plus besoin d'accéder à cette mémoire. La valeur par défaut est VRAI. Définissez cette valeur à FAUX quand vous souhaitez continuer à utiliser la référence après la fin de l'opération asynchrone. Par exemple, vous voudrez peut-être modifier les données dans LabVIEW avant de supprimer la référence. Si vous définissez la valeur à FAUX, vous devez utiliser la fonction Supprimer une référence de valeur de données pour supprimer la référence de données.

  • ignrn.png fichier tdms en sortie —

    tdms file out renvoie une référence de fichierTDMS au fichier .tdms sur lequel vous avez effectué l'opération.

  • ierrcodeclst.png sortie d'erreur —

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

  • ibool.png processus de lecture terminé ? —

    processus de lecture terminé ? indique si le processus de lecture est terminé ou non.

    Astuce Utilisez la valeur de ce booléen comme l'une des conditions d'arrêt d'une boucle While. Par exemple, vous pouvez placer la fonction TDMS - Lecture asynchrone (Avancée) (réf de données) dans la boucle While pour lire des données indéfiniment jusqu'à ce que la valeur de processus de lecture terminé ? renvoie VRAI. Cette valeur renvoie VRAI lorsqu'une des conditions suivantes a lieu :
    • La fonction TDMS - Lecture asynchrone (Avancée) (réf de données) atteint la fin d'un fichier .tdms.
    • La fonction TDMS - Lecture asynchrone (Avancée) (réf de données) finit de lire la taille totale de données spécifiée pour la fonction TDMS - Configurer des lectures asynchrones (réf de données).

    • Cette fonction peut générer des lectures asynchrones supplémentaires tout en exécutant en arrière-plan des lectures asynchrones initialisées plus tôt. Quand le nombre de lectures asynchrones en arrière-plan atteint la valeur maximale, cette fonction attend qu'une lecture asynchrone initialisée plus tôt soit terminée avant d'en initialiser une autre. Si la lecture asynchrone initialisée plus tôt ne se termine pas dans les délais spécifiés par la valeur de timeout, cette fonction renvoie le code d'erreur –2546. Utilisez la fonction TDMS - Configurer des lectures asynchrones (réf de données) pour configurer le nombre maximal de lectures asynchrones ainsi que la valeur du timeout.

    Utilisez la fonction TDMS - Obtenir l'état des lectures asynchrones (réf de données) pour obtenir le nombre de lectures asynchrones en attente.