MCI_WAVE_OPEN_PARMS structure

The MCI_WAVE_OPEN_PARMS structure contains information for MCI_OPEN command for waveform-audio devices.

Syntax

typedef struct {
  DWORD_PTR   dwCallback;
  MCIDEVICEID wDeviceID;
  LPCTSTR     lpstrDeviceType;
  LPCTSTR     lpstrElementName;
  LPCTSTR     lpstrAlias;
  DWORD       dwBufferSeconds;
} MCI_WAVE_OPEN_PARMS;

Members

dwCallback

The low-order word specifies a window handle used for the MCI_NOTIFY flag.

wDeviceID

Indentifier returned to application.

lpstrDeviceType

Name or constant identifier of the device type. (The name of the device is typically obtained from the registry or SYSTEM.INI file.) This member can be one of the values listed in MCI Device Types.

lpstrElementName

Device element name (usually a path).

lpstrAlias

Optional device alias.

dwBufferSeconds

Buffer length, in seconds.

Remarks

When assigning data to the members of this structure, set the corresponding flags in the fdwCommand parameter of the mciSendCommand function to validate the members.

You can use the MCI_OPEN_PARMS structure instead of MCI_WAVE_OPEN_PARMS if you are not using the extended data members.

Requirements

Requirement Value
Minimum supported client
Windows 2000 Professional [desktop apps only]
Minimum supported server
Windows 2000 Server [desktop apps only]
Header
Mciapi.h

See also

MCI

MCI Structures

MCI_OPEN

mciSendCommand

MCI_OPEN_PARMS