This message allows an application to allocate (or deallocate) buffers for use with the audio device. Buffers are limited to 64K on Intel machines.

ulParam1 (ULONG)

This parameter can contain any of the following flags:

MCI_NOTIFY

A notification message will be posted to the window specified in the hwndCallback field of the data structure pointed to by the pParam2 parameter. The notification will be posted when the action indicated by this message is completed or when an error occurs.
MCI_WAIT
Control is not to be returned until the action indicated by this message is completed or an error occurs.
MCI_ALLOCATE_MEMORY
Allocates memory for the mixer.
MCI_DEALLOCATE_MEMORY
Deallocates memory from the mixer.

pParam2 (PMCI_BUFFER_PARMS)

A pointer to an MCI_BUFFER_PARMS data structure.

rc (ULONG)

Return codes indicating success or type of failure:

MCIERR_SUCCESS

If the function succeeds, 0 is returned.
MCIERR_INVALID_DEVICE_ID
Invalid device ID given.
MCIERR_INVALID_FLAG
Invalid flag specified for this command.
MCIERR_INVALID_BUFFER
Buffer specified in the pBufList field of the MCI_BUFFER_PARMS structure is invalid.
MCIERR_INVALID_MODE
Command invalid for current mode.
MCIERR_OUT_OF_MEMORY
Memory could not be allocated.

---

[Back] [Next]