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 [デスクトップ アプリのみ] |
| ヘッダー |
|