commande MCI_GETDEVCAPS

Article
06/13/2023

La commande MCI_GETDEVCAPS récupère des informations statiques sur un appareil. Tous les appareils reconnaissent cette commande. Les paramètres et indicateurs disponibles pour cette commande dépendent de l’appareil sélectionné. Les informations sont retournées dans le membre dwReturn de la structure identifiée par lpCapsParms.

Pour envoyer cette commande, appelez la fonction mciSendCommand avec les paramètres suivants.

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_GETDEVCAPS, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_GETDEVCAPS_PARMS) lpCapsParms
);

Paramètres

wDeviceID: Identificateur de l’appareil MCI devant recevoir le message de commande.
dwFlags: MCI_NOTIFY, MCI_WAIT ou, pour les appareils de vidéo numérique et de magnétoscope, MCI_TEST. Pour plus d’informations sur ces indicateurs, consultez Indicateurs d’attente, de notification et de test.
lpCapsParms: Pointeur vers une structure MCI_GETDEVCAPS_PARMS .

Valeur renvoyée

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

Notes

Les indicateurs standard et spécifiques aux commandes suivants s’appliquent à tous les appareils prenant en charge MCI_GETDEVCAPS :

MCI_GETDEVCAPS_COMPOUND_DEVICE: Le membre dwReturn est défini sur TRUE si l’appareil utilise un stockage de données qui doit être explicitement ouvert et fermé ; dans le cas contraire, elle est définie sur FALSE .
MCI_GETDEVCAPS_DEVICE_TYPE: Le membre dwReturn est défini sur l’une des valeurs répertoriées dans Types d’appareils MCI.
MCI_GETDEVCAPS_HAS_AUDIO: Le membre dwReturn est défini sur TRUE si l’appareil a une sortie audio ; dans le cas contraire, elle est définie sur FALSE .
MCI_GETDEVCAPS_HAS_VIDEO: Le membre dwReturn est défini sur TRUE si l’appareil a une sortie vidéo ; dans le cas contraire, elle est définie sur FALSE . Par exemple, le membre est défini sur TRUE pour les appareils qui prennent en charge l’ensemble de commandes videodisc.
MCI_GETDEVCAPS_ITEM: Spécifie que le membre dwItem de la structure MCI_GETDEVCAPS_PARMS contient l’une des constantes suivantes :
MCI_GETDEVCAPS_CAN_EJECT: Le membre dwReturn est défini sur TRUE si l’appareil peut éjecter le média ; sinon, elle est définie sur FALSE.
MCI_GETDEVCAPS_CAN_PLAY: Le membre dwReturn est défini sur TRUE si l’appareil peut lire le média ; sinon, elle est définie sur FALSE. Si un appareil spécifie TRUE, cela signifie qu’il prend en charge les commandes MCI_PAUSE et MCI_STOP , ainsi que la commande MCI_PLAY .
MCI_GETDEVCAPS_CAN_RECORD: Le membre dwReturn est défini sur TRUE si l’appareil prend en charge l’enregistrement ; sinon, elle est définie sur FALSE. Si un appareil spécifie TRUE, cela signifie qu’il prend en charge les commandes MCI_PAUSE et MCI_STOP, ainsi que la commande MCI_RECORD .
MCI_GETDEVCAPS_CAN_SAVE: Le membre dwReturn est défini sur TRUE si l’appareil peut enregistrer un fichier ; sinon, elle est définie sur FALSE.
MCI_GETDEVCAPS_USES_FILES: Le membre dwReturn est défini sur TRUE si l’appareil nécessite un nom de fichier ; dans le cas contraire, elle est définie sur FALSE . Seuls les appareils composés utilisent des fichiers.

Les indicateurs suivants peuvent être spécifiés dans le membre dwItem de MCI_GETDEVCAPS_PARMS pour le type d’appareil digitalvideo :

MCI_DGV_GETDEVCAPS_CAN_FREEZE: Le membre dwReturn est défini sur TRUE si l’appareil peut figer les images ; sinon, elle est définie sur FALSE.
MCI_DGV_GETDEVCAPS_CAN_LOCK: Le membre dwReturn est défini sur TRUE si l’appareil peut se verrouiller ; sinon, elle est définie sur FALSE.
MCI_DGV_GETDEVCAPS_CAN_REVERSE: Le membre dwReturn est défini sur TRUE si l’appareil peut jouer à l’envers ; sinon, elle est définie sur FALSE.
MCI_DGV_GETDEVCAPS_CAN_STR_IN: Le membre dwReturn est défini sur TRUE si l’appareil peut étendre l’entrée ; sinon, elle est définie sur FALSE.
MCI_DGV_GETDEVCAPS_CAN_STRETCH: Le membre dwReturn est défini sur TRUE si l’appareil peut étirer une image ; sinon, elle est définie sur FALSE.
MCI_DGV_GETDEVCAPS_CAN_TEST: Le membre dwReturn est défini sur TRUE si l’appareil peut effectuer des tests ; sinon, elle est définie sur FALSE.
MCI_DGV_GETDEVCAPS_HAS_STILL: Le membre dwReturn est défini sur TRUE si l’appareil peut afficher des images fixes ; sinon, elle est définie sur FALSE.
MCI_DGV_GETDEVCAPS_MAX_WINDOWS: Le membre dwReturn est défini sur le nombre maximal de fenêtres que l’appareil peut gérer simultanément.
MCI_DGV_GETDEVCAPS_MAXIMUM_RATE: Le membre dwReturn est défini sur la vitesse de lecture maximale de l’appareil, en images par seconde.
MCI_DGV_GETDEVCAPS_MINIMUM_RATE: Le membre dwReturn est défini sur la vitesse de lecture minimale de l’appareil, en images par seconde.
MCI_DGV_GETDEVCAPS_PALETTES: Le membre dwReturn est défini sur TRUE si l’appareil peut retourner un handle de palette ; sinon, elle est définie sur FALSE.

Les indicateurs suivants peuvent être spécifiés dans le membre dwItem de MCI_GETDEVCAPS_PARMS pour le type d’appareil vcr :

MCI_GETDEVCAPS_CLOCK_INCREMENT_RATE: Le membre dwReturn est défini sur le nombre d’incréments par seconde.
MCI_VCR_GETDEVCAPS_CAN_DETECT_LENGTH: Le membre dwReturn est défini sur TRUE si l’appareil est capable de détecter la longueur du média ; sinon, elle est définie sur FALSE.
MCI_VCR_GETDEVCAPS_CAN_FREEZE: Le membre dwReturn est défini sur TRUE si l’appareil est capable de figer l’image de sortie ; sinon, elle est définie sur FALSE.
MCI_VCR_GETDEVCAPS_CAN_MONITOR_SOURCES: Le membre dwReturn est défini sur TRUE si l’appareil est capable de surveiller les sources ; sinon, elle est définie sur FALSE.
MCI_VCR_GETDEVCAPS_CAN_PREROLL: Le membre dwReturn est défini sur TRUE si l’appareil est capable de pré-inscription ; sinon, elle est définie sur FALSE.
MCI_VCR_GETDEVCAPS_CAN_PREVIEW: Le membre dwReturn est défini sur TRUE si l’appareil est capable d’afficher des aperçus ; sinon, elle est définie sur FALSE.
MCI_VCR_GETDEVCAPS_CAN_REVERSE: Le membre dwReturn est défini sur TRUE si l’appareil est capable de jouer à l’envers ; sinon, elle est définie sur FALSE.
MCI_VCR_GETDEVCAPS_CAN_TEST: Le membre dwReturn est défini sur TRUE si l’appareil est capable de tester ; sinon, elle est définie sur FALSE.
MCI_VCR_GETDEVCAPS_HAS_CLOCK: Le membre dwReturn est défini sur TRUE si l’appareil prend en charge une horloge externe ; sinon, elle est définie sur FALSE.
MCI_VCR_GETDEVCAPS_HAS_TIMECODE: Le membre dwReturn est défini sur TRUE si l’appareil dispose d’une fonctionnalité de timecode ou si cette fonctionnalité est inconnue ; sinon, elle est définie sur FALSE.
MCI_VCR_GETDEVCAPS_NUMBER_OF_MARKS: Le membre dwReturn est défini sur le nombre de marques (99).
MCI_VCR_GETDEVCAPS_SEEK_ACCURACY: Le membre dwReturn est défini sur la précision de recherche de l’appareil.

Les indicateurs suivants peuvent être spécifiés dans le membre dwItem de MCI_GETDEVCAPS_PARMS pour le type d’appareil de superposition :

MCI_OVLY_GETDEVCAPS_CAN_FREEZE: Le membre dwReturn est défini sur TRUE si l’appareil peut figer l’image ; sinon, elle est définie sur FALSE.
MCI_OVLY_GETDEVCAPS_CAN_STRETCH: Le membre dwReturn est défini sur TRUE si l’appareil peut étirer l’image pour remplir le cadre ; sinon, elle est définie sur FALSE.
MCI_OVLY_GETDEVCAPS_MAX_WINDOWS: Le membre dwReturn est défini sur le nombre maximal de fenêtres que l’appareil peut gérer simultanément.

Les indicateurs suivants peuvent être spécifiés dans le membre dwItem de MCI_GETDEVCAPS_PARMS pour le type d’appareil videodisc :

MCI_VD_GETDEVCAPS_CAN_REVERSE: Le membre dwReturn est défini sur TRUE si le lecteur videodisc peut être lu à l’envers ; sinon, elle est définie sur FALSE. Certains joueurs peuvent lire des disques CLV à l’envers ainsi que des disques CAV.
MCI_VD_GETDEVCAPS_CAV: En cas de combinaison avec d’autres éléments, spécifie que les informations de retour s’appliquent aux vidéodiscs au format CAV. Il s’agit de la valeur par défaut si aucun vidéodisc n’est inséré.
MCI_VD_GETDEVCAPS_CLV: En cas de combinaison avec d’autres éléments, spécifie que les informations de retour s’appliquent aux vidéodiscs au format CLV.
MCI_VD_GETDEVCAPS_FAST_RATE: Le membre dwReturn est défini sur la vitesse de lecture rapide standard en images par seconde.
MCI_VD_GETDEVCAPS_NORMAL_RATE: Le membre dwReturn est défini sur la vitesse de lecture normale en images par seconde.
MCI_VD_GETDEVCAPS_SLOW_RATE: Le membre dwReturn est défini sur la vitesse de lecture lente standard en images par seconde.

Les indicateurs suivants peuvent être spécifiés dans le membre dwItem de MCI_GETDEVCAPS_PARMS pour le type d’appareil waveaudio :

MCI_WAVE_GETDEVCAPS_INPUT: Le membre dwReturn est défini sur le nombre total d’appareils d’entrée de forme d’onde (enregistrement).
MCI_WAVE_GETDEVCAPS_OUTPUT: Le membre dwReturn est défini sur le nombre total d’appareils de sortie (lecture) de forme d’onde.

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]
En-tête	Mmsystem.h (inclure Windows.h)

Voir aussi

MCI
Commandes MCI

Partager via