Condividi tramite


Metodo IWMDMDeviceControl::Record (mswmdm.h)

Il metodo Record inizia la registrazione dall'input del record esterno del dispositivo nella posizione di ricerca corrente. Il metodo IWMDMDeviceControl::Seek deve essere chiamato per primo.

Sintassi

HRESULT Record(
  [in] _WAVEFORMATEX *pFormat
);

Parametri

[in] pFormat

Puntatore a una struttura _WAVEFORMATEX che specifica il formato in cui devono essere registrati i dati.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito Descrizione
S_OK
Il metodo è riuscito.
E_BUSY
Il dispositivo sta già eseguendo un'operazione.
WMDM_E_NOTSUPPORTED
La funzione di record non è implementata in questo dispositivo.
E_FAIL
Si è verificato un errore non specificato.

Commenti

Questo metodo viene usato per richiamare sia la registrazione del dispositivo (registrazione di una traccia audio da archiviare nel dispositivo multimediale) sia lo streaming di dati audio dal dispositivo multimediale da registrare nel computer. Il metodo Seek determina quale forma di registrazione si verifica.

Alcuni dispositivi non supportano nessuno dei due tipi di registrazione. Il metodo GetCapabilities deve essere chiamato prima di iniziare la registrazione. Se viene tentato un tipo di registrazione non supportato, questo metodo restituisce WMDM_E_NOTSUPPORTED.

È possibile specificare un argomento per il parametro pFormat per specificare un formato audio per la registrazione. Per determinare i formati supportati dal dispositivo, vedere GetFormatSupport. Se il parametro pFormat è impostato su NULL, il dispositivo registra i dati audio nel formato predefinito.

Quando si usa la registrazione del dispositivo, è necessario enumerare il contenuto del supporto di archiviazione per trovare il nuovo oggetto al termine dell'operazione di record.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione mswmdm.h
Libreria Mssachlp.lib

Vedi anche

IWMDMDevice::GetFormatSupport

Interfaccia IWMDMDeviceControl

IWMDMDeviceControl::GetCapabilities

IWMDMDeviceControl::Seek

Interfaccia IWMDMObjectInfo

_WAVEFORMATEX