MCI_SYSINFO コマンド

  • [アーティクル]

MCI_SYSINFO コマンドは、MCI デバイスに関する情報を取得します。 MCI は、このコマンドをデバイスに渡すのではなく、直接サポートします。 どの MCI アプリケーションでも、このコマンドを使用できます。 文字列情報は、lpSysInfo によって識別される構造体の lpstrReturn メンバーが指すアプリケーション提供のバッファーで返されます。 数値情報は、アプリケーション提供のバッファーに配置された DWORD 値として返されます。 dwRetSize メンバーは、バッファーの長さを指定します。

このコマンドを送信するには、次のパラメーターを指定して mciSendCommand 関数を呼び出します。

MCIERROR mciSendCommand(
  MCIDEVICEID wDeviceID, 
  MCI_SYSINFO, 
  DWORD dwFlags, 
  (DWORD) (LPMCI_SYSINFO_PARMS) lpSysInfo
);

パラメーター

wDeviceID

コマンド メッセージを受信する MCI デバイスのデバイス識別子。

dwFlags

次の標準およびコマンド固有のフラグの 1 つ以上。

MCI_SYSINFO_INSTALLNAME

デバイスのインストールに使用する名前 (レジストリまたはSYSTEM.INI ファイルに記載されている) を取得します。

MCI_SYSINFO_NAME

lpSysInfo で識別される構造体の dwNumber メンバーで指定されたデバイス番号に対応するデバイス名を取得します。 MCI_SYSINFO_OPEN フラグが設定されている場合、MCI は開いているデバイスの名前を返します。

MCI_SYSINFO_OPEN

開いているデバイスの数量または名前を取得します。

MCI_SYSINFO_QUANTITY

レジストリまたはSYSTEM.INI ファイルの [mci] セクションに一覧表示されている、指定した種類のデバイスの数を取得します。 MCI_SYSINFO_OPEN フラグが設定されている場合は、開いているデバイスの数が返されます。

lpSysInfo

MCI_SYSINFO_PARMS構造体へのポインター。

戻り値

成功した場合は 0 を返し、それ以外の場合はエラーを返します。

注釈

lpSysInfo によって識別される構造体の wDeviceType メンバーは、クエリのデバイスの種類を示すために使用されます。 wDeviceID パラメーターが MCI_ALL_DEVICE_ID に設定されている場合は、wDeviceType の値をオーバーライドします。 デバイスの種類の一覧については、「 MCI デバイスの種類」を参照してください。

整数の戻り値は、lpSysInfo によって識別される構造体の lpstrReturn メンバーによって指されるバッファーで返される DWORD 値です。

文字列の戻り値は、lpSysInfo で識別される構造体の lpstrReturn メンバーが指すバッファーで返される null で終わる文字列です。

要件

要件 値
サポートされている最小のクライアント
 Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー
Mmsystem.h (Windows.h を含む)

こちらもご覧ください

Mci

MCI コマンド