Condividi tramite

Funzione midiStreamProperty (mmeapi.h)

  • Articolo

La funzione midiStreamProperty imposta o recupera le proprietà di un flusso di dati MIDI associato a un dispositivo di output MIDI.

Sintassi

MMRESULT midiStreamProperty(
  HMIDISTRM hms,
  LPBYTE    lppropdata,
  DWORD     dwProperty
);

Parametri

hms

Gestire il dispositivo MIDI a cui è associata la proprietà.

lppropdata

Puntatore ai dati della proprietà.

dwProperty

Flag che specificano l'azione da eseguire e identificare la proprietà appropriata del flusso di dati MIDI. La funzione midiStreamProperty richiede l'impostazione di due flag in ogni uso. Un flag (MIDIPROP_GET o MIDIPROP_SET) specifica un'azione e l'altro identifica una proprietà specifica da esaminare o modificare.

Valore Significato
MIDIPROP_GET Recupera l'impostazione corrente della proprietà specificata.
MIDIPROP_SET Imposta la proprietà specificata.
MIDIPROP_TEMPO Recupera la proprietà tempo. Il parametro lppropdata punta a una struttura MIDIPROPTEMPO . Il valore del tempo corrente può essere recuperato in qualsiasi momento. I dispositivi di output impostano il tempo inserendo MEVT_TEMPO eventi nei dati MIDI.
MIDIPROP_TIMEDIV Specifica la proprietà della divisione temporale. È possibile ottenere o impostare questa proprietà. Il parametro lppropdata punta a una struttura MIDIPROPTIMEDIV . Questa proprietà può essere impostata solo quando il dispositivo viene arrestato.

Valore restituito

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

Codice restituito Descrizione
MMSYSERR_INVALHANDLE
 L'handle specificato non è un handle di flusso.
MMSYSERR_INVALPARAM
 Il parametro handle o flag specificato non è valido.

Commenti

Queste proprietà sono le proprietà predefinite definite dal sistema. I writer di driver possono implementare e documentare le proprie proprietà.

Requisiti

Requisito Valore
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

Funzioni MIDI