IWMDMDeviceControl ::Record, méthode (mswmdm.h)

Article
03/04/2024

La méthode Record commence l’enregistrement à partir de l’entrée d’enregistrement externe de l’appareil à la position de recherche actuelle. La méthode IWMDMDeviceControl ::Seek doit être appelée en premier.

Syntaxe

HRESULT Record(
  [in] _WAVEFORMATEX *pFormat
);

Paramètres

[in] pFormat

Pointeur vers une structure de _WAVEFORMATEX spécifiant le format dans lequel les données doivent être enregistrées.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK
E_BUSY	L’appareil effectue déjà une opération.
WMDM_E_NOTSUPPORTED	La fonction d’enregistrement n’est pas implémentée sur cet appareil.
E_FAIL	Une erreur non spécifiée s'est produite.

Remarques

Cette méthode est utilisée pour appeler à la fois l’enregistrement de l’appareil (enregistrement d’une piste audio à stocker sur le périphérique multimédia) et la diffusion en continu des données audio à partir de l’appareil multimédia à enregistrer sur l’ordinateur. La méthode Seek détermine la forme d’enregistrement qui se produit.

Certains appareils ne prennent pas en charge l’un ou l’autre type d’enregistrement. La méthode GetCapabilities doit être appelée avant de commencer l’enregistrement. Si un type d’enregistrement non pris en charge est tenté, cette méthode retourne WMDM_E_NOTSUPPORTED.

Un argument peut être fourni pour le paramètre pFormat afin de spécifier un format audio pour l’enregistrement. Pour déterminer les formats pris en charge par l’appareil, consultez GetFormatSupport. Si le paramètre pFormat a la valeur NULL, l’appareil enregistre les données audio au format par défaut.

Lorsque vous utilisez l’enregistrement de l’appareil, vous devez énumérer le contenu du support de stockage pour rechercher le nouvel objet une fois l’opération d’enregistrement terminée.