funzione waveInOpen (mmeapi.h)
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 |
|---|---|
|
La risorsa specificata è già allocata. |
|
L'identificatore del dispositivo specificato non è compreso nell'intervallo. |
|
Non è presente alcun driver di dispositivo. |
|
Impossibile allocare o bloccare la memoria. |
|
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 |