Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

info command

The info command retrieves a hardware description from a device. All MCI devices recognize this command.

To send this command, call the mciSendString function with the lpszCommand parameter set as follows.


_stprintf_s(
  lpszCommand, 
  TEXT("info %s %s %s"), 
  lpszDeviceID, 
  lpszInfoType, 
  lpszFlags
); 

Parameters

lpszDeviceID

Identifier of an MCI device. This identifier or alias is assigned when the device is opened.

lpszInfoType

Flag that identifies the type of information required. The following table lists device types that recognize the info command and the flags used by each type.

ValueMeaningMeaning
cdaudioinfo identityinfo upcproduct
digitalvideoaudio algorithmaudio qualityfileproductstill algorithmstill qualityusageversionvideo algorithmvideo qualitywindow text
overlayfileproductwindow text
sequencercopyrightfilenameproduct
vcrproductversion
videodiskproduct
waveaudiofileinputoutputproduct

 

The following table lists the flags that can be specified in the lpszInfoType parameter and their meanings.

ValueMeaning
audio algorithmReturns the name of the current audio compression algorithm.
audio qualityReturns the name for the current audio quality descriptor. This might return "unknown" if the application has set parameters to specific values that do not correspond to defined qualities.
copyrightRetrieves the MIDI file copyright notice from the copyright meta event.
fileRetrieves the name of the file used by the compound device. If the device is opened without a file and the load command has not been used, a null string is returned.
info identityProduces a unique identifier for the audio CD currently loaded in the player being queried.
info upcProduces 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.
inputRetrieves the description of the current input device. Returns "none" if an input device is not set.
nameRetrieves the sequence name from the sequence/track name meta event.
outputRetrieves the description of the current output device. Returns "none" if an output device is not set.
productRetrieves a description of the device. This information often includes the product name and model. The string length will be 31 characters or fewer.
still algorithmReturns the name of the current still image compression algorithm.
still qualityReturns the name for the current still image quality descriptor. This might return "unknown" if the application has set parameters to specific values that do not correspond to defined qualities.
usageReturns a string describing usage restrictions that might be imposed by the owner of the visual or audio data in the workspace.
versionReturns the release level of the device driver and hardware.
video algorithmReturns the name of the current video compression algorithm.
video qualityReturns the name for the current video quality descriptor. This might return "unknown" if the application has set parameters to specific values that do not correspond to defined qualities.
window textRetrieves the caption of the window used by the device.

 

lpszFlags

Can be "wait", "notify", or both. For digital-video and VCR devices, "test" can also be specified. For more information about these flags, see The Wait, Notify, and Test Flags.

Return Value

Returns zero if successful or an error otherwise.

Examples

The following command retrieves a description of the hardware associated with the "mysound" device.

info mysound product

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

See also

MCI
MCI Command Strings
load

 

 

Community Additions

Show:
© 2014 Microsoft