commande MCI_GETDEVCAPS

  • Article

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