Share via

funzione waveInOpen (mmeapi.h)

  • Articolo

La funzione waveInOpen apre il dispositivo di input audio waveform specificato per la registrazione.

Sintassi

MMRESULT waveInOpen(
  LPHWAVEIN       phwi,
  UINT            uDeviceID,
  LPCWAVEFORMATEX pwfx,
  DWORD_PTR       dwCallback,
  DWORD_PTR       dwInstance,
  DWORD           fdwOpen
);

Parametri

phwi

Puntatore a un buffer che riceve un handle che identifica il dispositivo di input audio a onda aperta. Usare questo handle per identificare il dispositivo quando si chiamano altre funzioni di input audio waveform. Questo parametro può essere NULL se viene specificato WAVE_FORMAT_QUERY per fdwOpen.

uDeviceID

Identificatore del dispositivo di input audio a forma d'onda da aprire. Può essere un identificatore di dispositivo o un handle di un dispositivo di input audio a onda aperta. È possibile usare il flag seguente anziché un identificatore di dispositivo.

Valore Significato
WAVE_MAPPER La funzione seleziona un dispositivo di input audio waveform in grado di registrare nel formato specificato.

pwfx

Puntatore a una struttura WAVEFORMATEX che identifica il formato desiderato per la registrazione di dati audio waveform. È possibile liberare questa struttura immediatamente dopo la restituzione di waveInOpen .

dwCallback

Puntatore a una funzione di callback fissa, un handle di evento, un handle a una finestra o l'identificatore di un thread da chiamare durante la registrazione audio a onde per elaborare i messaggi correlati allo stato di avanzamento della registrazione. Se non è necessaria alcuna funzione di callback, questo valore può essere zero. Per altre informazioni sulla funzione di callback, vedere waveInProc.

dwInstance

Dati dell'istanza utente passati al meccanismo di callback. Questo parametro non viene usato con il meccanismo di callback della finestra.

fdwOpen

Flag per l'apertura del dispositivo. Vengono definiti i valori seguenti.

Valore Significato
CALLBACK_EVENT Il parametro dwCallback è un handle di evento.
CALLBACK_FUNCTION Il parametro dwCallback è un indirizzo di routine di callback.
CALLBACK_NULL Nessun meccanismo di callback. Si tratta dell'impostazione predefinita.
CALLBACK_THREAD Il parametro dwCallback è un identificatore di thread.
CALLBACK_WINDOW Il parametro dwCallback è un handle di finestra.
WAVE_MAPPED_DEFAULT_COMMUNICATION_DEVICE Se questo flag viene specificato e il parametro uDeviceID è WAVE_MAPPER, la funzione apre il dispositivo di comunicazione predefinito.

Questo flag si applica solo quando uDeviceID è uguale a WAVE_MAPPER.

Nota Richiede Windows 7
 
WAVE_FORMAT_DIRECT Se questo flag viene specificato, il driver ACM non esegue conversioni sui dati audio.
WAVE_FORMAT_QUERY La funzione esegue una query sul dispositivo per determinare se supporta il formato specificato, ma non apre il dispositivo.
WAVE_MAPPED Il parametro uDeviceID specifica un dispositivo waveform-audio a cui eseguire il mapping da parte del mapper d'onda.

Valore restituito

Restituisce MMSYSERR_NOERROR in caso di esito positivo o di errore in caso contrario. I valori di errore possibili includono quanto segue.

Codice restituito Descrizione
MMSYSERR_ALLOCATED
 La risorsa specificata è già allocata.
MMSYSERR_BADDEVICEID
 L'identificatore del dispositivo specificato non è compreso nell'intervallo.
MMSYSERR_NODRIVER
 Non è presente alcun driver di dispositivo.
MMSYSERR_NOMEM
 Impossibile allocare o bloccare la memoria.
WAVERR_BADFORMAT
 Si è tentato di aprire con un formato audio waveform non supportato.

Commenti

Usare la funzione waveInGetNumDevs per determinare il numero di dispositivi di input audio waveform presenti nel sistema. L'identificatore del dispositivo specificato da uDeviceID varia da zero a uno minore del numero di dispositivi presenti. La costante WAVE_MAPPER può essere usata anche come identificatore del dispositivo.

Se si sceglie di avere una finestra o un thread che riceve informazioni di callback, i messaggi seguenti vengono inviati alla routine o al thread della finestra per indicare lo stato di avanzamento dell'input audio waveform: MM_WIM_OPEN, MM_WIM_CLOSE e MM_WIM_DATA.

Se si sceglie di ricevere informazioni di callback per una funzione, i messaggi seguenti vengono inviati alla funzione per indicare lo stato di avanzamento dell'input audio a forma d'onda: WIM_OPEN, WIM_CLOSE e WIM_DATA.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione mmeapi.h (include Windows.h)
Libreria Winmm.lib
DLL Winmm.dll

Vedi anche

Waveform Audio

Funzioni waveform