commande signal

La commande signal identifie une position spécifiée dans l’espace de travail en envoyant à l’application un message MM_MCISIGNAL . Les appareils vidéo numériques reconnaissent cette commande. MCIAVI ne prend en charge qu’un seul signal actif à la fois.

Pour envoyer cette commande, appelez la fonction mciSendString avec le paramètre lpszCommand défini comme suit.

_stprintf_s(
  lpszCommand, 
  TEXT("signal %s %s %s"), 
  lpszDeviceID, 
  lpszSignalFlags, 
  lpszFlags
); 

Paramètres

lpszDeviceID

Identificateur d’un appareil MCI. Cet identificateur ou alias est affecté à l’ouverture de l’appareil.

lpszSignalFlags

L’un des indicateurs suivants.

Valeur	Signification
à la position	Spécifie le frame à appeler un signal.
annuler	Supprime les signaux de l’espace de travail. Un signal individuel est spécifié à l’aide de l’indicateur « uservalue ». Si l’indicateur « uservalue » n’est pas spécifié à l’aide de « cancel », l’appareil annule tous les signaux. L’indicateur « cancel » est incompatible avec les indicateurs « at », « every » et « return position ».
tous les intervalles	Spécifie la période des signaux. La valeur d’intervalle est spécifiée dans le format d’heure actuel. S’ils sont utilisés avec la position « at », les signaux sont placés dans l’ensemble de l’espace de travail avec une marque de signal placée à la position. Sans l’indicateur « at », les signaux sont placés dans l’espace de travail avec un signal à la position actuelle. Si cet indicateur est omis, seule la position indiquée par l’indicateur « at » est marquée. Si la valeur d’intervalle est inférieure à la fréquence minimale prise en charge par un appareil, il utilise sa valeur minimale.
position de retour	Indique que l’appareil doit envoyer la valeur de position au lieu de l’identificateur « uservalue » dans le message de signalisation. L’identificateur « uservalue » peut toujours être utilisé pour annuler ou redéfinir les marques de signal.
id uservalue	Spécifie un identificateur qui est signalé avec le message de signalisation. Cet identificateur agit comme un identificateur qui peut être utilisé avec d’autres commandes de signal pour référencer ce paramètre de signal . En cas d’omission, la valeur par défaut est zéro.

lpszFlags

Il peut s’agir de « wait », « notify », « test » ou d’une combinaison de ceux-ci. Pour plus d’informations sur ces indicateurs, consultez Indicateurs d’attente, de notification et de test.

Valeur renvoyée

Retourne zéro en cas de réussite ou une erreur dans le cas contraire.

Notes

Le handle de fenêtre utilisé pour la notification des messages d’achèvement de commande est également utilisé pour la signalisation.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]

Voir aussi

MCI

Chaînes de commande MCI

MM_MCISIGNAL