funzione MODM_STRMDATA

WINMM invia il MODM_STRMDATA messaggio alla funzione modMessage di un driver di output MIDI per ottenere il dispositivo di output MIDI per inviare i dati del flusso.

Sintassi

DWORD modMessage(
   UINT      uDeviceID,
   UINT      uMsg,
   DWORD_PTR dwUser,
   DWORD_PTR dwParam1,
   DWORD_PTR dwParam2
);

Parametri

• uDeviceID
  Specifica l'ID del dispositivo di destinazione. Gli ID dispositivo sono sequenziali e hanno un valore iniziale pari a zero e un valore finale uguale a uno minore del numero di dispositivi supportati dal driver.

• Umsg
  WINMM imposta questo parametro su MODM_STRMDATA quando chiama modMessage per elaborare questo messaggio.

• dwUser
  Usare questo parametro per restituire i dati dell'istanza al driver. I driver che supportano più client possono usare questi dati di istanza per tenere traccia del client associato al messaggio.

• dwParam1
  Questo parametro specifica un puntatore lontano alla struttura MIDIHDR che contiene i dati nel formato del buffer di flusso.

• dwParam2
  Questo parametro specifica le dimensioni, in byte, della struttura MIDIHDR .

Valore restituito

La funzione modMessage restituisce MMSYSERR_NOERROR se l'operazione ha avuto esito positivo. In caso contrario, restituisce MMSYSERR_NOTENABLED per indicare che il driver non è riuscito a caricare o inizializzare.

Commenti

Il membro dwStreamID della struttura MIDIEVENT è documentato come riservato nella documentazione di Windows SDK. Questo membro contiene effettivamente la destinazione dell'evento specificato. Il driver deve elaborare l'evento solo nelle circostanze seguenti:

• dwStreamID corrisponde a uno degli identificatori di flusso specificati nella matrice specificata dal membro rgIds della struttura MIDIOPENDESC (specificato nel messaggio MODM_OPEN ). In questo caso, il driver deve elaborare l'evento sulla porta a cui l'identificatore del flusso è stato associato tramite un identificatore del dispositivo nel messaggio MODM_OPEN .

• dwStreamID contiene -1 (0xFFFFFFFFL). In questo caso, il driver deve elaborare l'evento per tutte le porte aperte in questo flusso.

Requisiti

Vedi anche

modMessage

MIDIHDR

MIDIEVENT

MIDIOPENDESC