befehl MCI_SYSINFO

Artikel
06/13/2023

Der Befehl MCI_SYSINFO ruft Informationen zu MCI-Geräten ab. MCI unterstützt diesen Befehl direkt, anstatt ihn an das Gerät zu übergeben. Dieser Befehl kann von jeder MCI-Anwendung verwendet werden. Zeichenfolgeninformationen werden im von der Anwendung bereitgestellten Puffer zurückgegeben, auf den das lpstrReturn-Element der struktur verweist, die von lpSysInfo identifiziert wird. Numerische Informationen werden als DWORD-Wert zurückgegeben, der im von der Anwendung bereitgestellten Puffer platziert wird. Das dwRetSize-Element gibt die Pufferlänge an.

Um diesen Befehl zu senden, rufen Sie die mciSendCommand-Funktion mit den folgenden Parametern auf.

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

Parameter

wDeviceID: Geräte-ID des MCI-Geräts, das die Befehlsnachricht empfangen soll.
dwFlags: Mindestens eines der folgenden Standard- und befehlsspezifischen Flags:
MCI_SYSINFO_INSTALLNAME: Ruft den Namen (in der Registrierung oder in der SYSTEM.INI-Datei aufgeführt) ab, der zum Installieren des Geräts verwendet wird.
MCI_SYSINFO_NAME: Ruft einen Gerätenamen ab, der der Gerätenummer entspricht, die im dwNumber-Element der durchlpSysInfo identifizierten Struktur angegeben ist. Wenn das flag MCI_SYSINFO_OPEN festgelegt ist, gibt MCI die Namen geöffneter Geräte zurück.
MCI_SYSINFO_OPEN: Ruft die Menge oder den Namen geöffneter Geräte ab.
MCI_SYSINFO_QUANTITY: Ruft die Anzahl der Geräte des angegebenen Typs ab, die in der Registrierung oder im Abschnitt [mci] der SYSTEM.INI-Datei aufgeführt sind. Wenn das flag MCI_SYSINFO_OPEN festgelegt ist, wird die Anzahl der geöffneten Geräte zurückgegeben.
lpSysInfo: Zeiger auf eine MCI_SYSINFO_PARMS-Struktur .

Rückgabewert

Gibt null zurück, wenn erfolgreich oder andernfalls ein Fehler auftritt.

Bemerkungen

Der wDeviceType-Member der durch lpSysInfo identifizierten Struktur wird verwendet, um den Gerätetyp der Abfrage anzugeben. Wenn der wDeviceID-Parameter auf MCI_ALL_DEVICE_ID festgelegt ist, überschreibt er den Wert von wDeviceType. Eine Liste der Gerätetypen finden Sie unter MCI-Gerätetypen.

Ganzzahlige Rückgabewerte sind DWORD-Werte , die im Puffer zurückgegeben werden, auf den der lpstrReturn-Member der von lpSysInfo identifizierten Struktur verweist.

Zeichenfolgenrückgabewerte sind NULL-terminierte Zeichenfolgen, die im Puffer zurückgegeben werden, auf den das lpstrReturn-Element der struktur verweist, die von lpSysInfo identifiziert wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Mmsystem.h (windows.h einschließen)

Siehe auch

MCI
MCI-Befehle

Freigeben über