Funzione midiStreamProperty (mmeapi.h)

Articolo
08/24/2023

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

Condividi tramite