Metodo IMDSPDeviceControl::Record (mswmdm.h)

Articolo
03/05/2024

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

Sintassi

HRESULT Record(
  [in] _WAVEFORMATEX *pFormat
);

Parametri

[in] pFormat

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

Valore restituito

Il metodo restituisce un 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 esegue già un'operazione.
WMDM_E_NOTSUPPORTED	La funzione di record non viene implementata in questo dispositivo.
E_FAIL	Si è verificato un errore non specificato.

Commenti

Questo metodo viene usato per richiamare la registrazione dei dispositivi (registrazione di una traccia audio da archiviare nel dispositivo multimediale) e trasmettere dati audio dal dispositivo multimediale da registrare nel computer. Il metodo Seek determina quale forma di registrazione si verifica.

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

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

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