MCI_INFO - Win32 Multimedia Programmer's Reference

Custom Search

	Overview

	Group

	Quick Info

MCI_INFO

The MCI_INFO command retrieves string information from a device. All devices recognize this command. Information is returned in the lpstrReturn member of the structure identified by lpInfo. The dwRetSize member specifies the buffer length for the returned data.

MCIERROR mciSendCommand(MCIDEVICEID wDeviceID, MCI_INFO,
DWORD dwFlags, (DWORD) (LPMCI_INFO_PARMS) lpInfo);

Parameters
wDeviceID
Device identifier of the MCI device that is to receive the command message.

dwFlags
MCI_NOTIFY, MCI_WAIT, or, for digital-video and VCR devices, MCI_TEST. For information about these flags, see The Wait, Notify, and Test Flags.

lpInfo

Address of an MCI_INFO_PARMS structure. (Devices with extended command sets might replace this structure with a device-specific structure.)

Return Values
Returns zero if successful or an error otherwise.

Remarks
The following additional standard and command-specific flag applies to all devices supporting MCI_INFO:

MCI_INFO_PRODUCT

Obtains a description of the hardware associated with a device. Devices should supply a description that identifies both the driver and the hardware used.

The following additional flags apply to the cdaudio device type:

MCI_INFO_MEDIA_IDENTITY

Produces a unique identifier for the audio CD currently loaded in the player being queried. This flag returns a string of 16 hexadecimal digits.

MCI_INFO_MEDIA_UPC

Produces the Universal Product Code (UPC) that is encoded on an audio CD. The UPC is a string of digits. It might not be available for all CDs.

The following additional flags apply to the digitalvideo device type:

MCI_DGV_INFO_ITEM

A constant indicating the information desired is included in the dwItem member of the structure identified by lpInfo. The following constants are defined for digital-video devices:

MCI_DGV_INFO_AUDIO_ALG

Returns the name for the current audio compression algorithm.

MCI_DGV_INFO_AUDIO_QUALITY

Returns the name for the current audio quality descriptor.

MCI_DGV_INFO_STILL_ALG

Returns the name for the current still image compression algorithm.

MCI_DGV_INFO_STILL_QUALITY

Returns the name for the current still image quality descriptor.

MCI_DGV_INFO_USAGE

Returns a string describing usage restrictions that might be imposed by the owner of the visual or audible data in the workspace.

MCI_DGV_INFO_VIDEO_ALG

Returns the name for the current video compression algorithm.

MCI_DGV_INFO_VIDEO_QUALITY

Returns the name for the current video quality descriptor.

MCI_INFO_VERSION

Returns the release level of the device driver and hardware. Device driver developers must document the syntax of the returned string.

MCI_DGV_INFO_TEXT

Obtains the window caption.

MCI_INFO_FILE

Obtains the path and filename of the last file specified with the MCI_OPEN or MCI_LOAD command. If a file has not been specified, the device returns a null-terminated string. This flag is supported only by devices that return TRUE to the MCI_GETDEVCAPS_USES_FILES flag of the MCI_GETDEVCAPS command.

For digital-video devices, lpInfo points to an MCI_DGV_INFO_PARMS structure.

The following additional flags apply to the sequencer device type:

MCI_INFO_COPYRIGHT

Obtains the MIDI file copyright notice from the copyright meta event.

MCI_INFO_FILE

Obtains the filename of the current file. This flag is supported only by devices that return TRUE when you call the MCI_GETDEVCAPS command with the MCI_GETDEVCAPS_USES_FILES flag.

MCI_INFO_NAME

Obtains the sequence name from the sequence/track name meta event.

The following additional flag applies to the vcr device type:

MCI_VCR_INFO_VERSION

Sets lpstrReturn member of the MCI_INFO_PARMS structure to point to the version number. Also sets the dwRetSize member equal to the length of the string pointed to.

The following additional flags apply to the overlay device type:

MCI_INFO_FILE

Obtains the filename of the current file. This flag is supported only by devices that return TRUE to the MCI_GETDEVCAPS_USES_FILES flag of the MCI_GETDEVCAPS command.

MCI_OVLY_INFO_TEXT

Obtains the caption of the window associated with the video-overlay device.

The following additional flags apply to the waveaudio device type:

MCI_INFO_FILE

Obtains the filename of the current file. This flag is supported by devices that return TRUE when you call the MCI_GETDEVCAPS command with the MCI_GETDEVCAPS_USES_FILES flag.

MCI_WAVE_INPUT

Obtains the product name of the current input.

MCI_WAVE_OUTPUT

Obtains the product name of the current output and its value is device specific.

See Also
MCI_DGV_INFO_PARMS, MCI_GETDEVCAPS, MCI_INFO_PARMS, MCI_LOAD, I_OPEN

Last news from Greatis Software

    Nostalgia .Net     .Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More »

Recommended software for developers

    Ultimate Pack     Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More »

    Form Designer .Net     Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More »

    Print Suite .Net     Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More »

    Gradient Controls .Net     Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More »

    Greatis iGrid     iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More »

All the contacts and projects

Dmitry Vasiliev (just.dmitry)

More Online Helps

Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages

greatis just4fun network