CM_Add_IDA-Funktion (cfgmgr32.h)
Die funktion CM_Add_ID fügt eine angegebene Geräte-ID (sofern nicht bereits vorhanden) an die Hardware-ID-Liste oder die Liste der kompatiblen ID eines Geräts instance an.
Syntax
CMAPI CONFIGRET CM_Add_IDA(
DEVINST dnDevInst,
PSTR pszID,
ULONG ulFlags
);
Parameter
dnDevInst
Vom Aufrufer bereitgestelltes Gerät instance Handle, das an den lokalen Computer gebunden ist.
pszID
Vom Aufrufer bereitgestellter Zeiger auf eine MIT NULL endende Geräte-ID-Zeichenfolge.
ulFlags
Vom Aufrufer bereitgestellte Flagkonstante, die die Liste angibt, an die die angegebene Geräte-ID angefügt werden soll. Die folgenden Flagkonstanten sind gültig.
| Flagkonstante | Definition |
|---|---|
| CM_ADD_ID_COMPATIBLE | Die angegebene Geräte-ID sollte an die Liste der kompatiblen ID des jeweiligen Geräts instance angefügt werden. |
| CM_ADD_ID_HARDWARE | Die angegebene Geräte-ID sollte an die Hardware-ID-Liste des jeweiligen Geräts instance angefügt werden. |
Rückgabewert
Wenn der Vorgang erfolgreich ist, gibt die Funktion CR_SUCCESS zurück. Andernfalls wird einer der in Cfgmgr32.h definierten Fehlercodes mit CR_ Präfix zurückgegeben.
Hinweise
Die funktion CM_Add_ID kann nur verwendet werden, wenn dnDevInst ein root-enumeriertes Gerät darstellt. Bei anderen Geräten meldet der Bustreiber Hardware und kompatible IDs, wenn er ein untergeordnetes Gerät aufzählt, nachdem er IRP_MN_QUERY_ID empfangen hat.
Jede angefügte Geräte-ID gilt als weniger kompatibel als IDs, die bereits in der angegebenen Liste vorhanden sind. Informationen zu Geräte-IDs, Hardware-IDs und kompatiblen IDs finden Sie unter Geräteidentifikationszeichenfolgen.
Aufrufer dieser Funktion müssen über SeLoadDriverPrivilege verfügen. (Berechtigungen werden in der dokumentation Microsoft Windows SDK beschrieben.)
Informationen zur Verwendung von Geräte- instance Handles, die an den lokalen Computer gebunden sind, finden Sie unter CM_Get_Child.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
| Zielplattform | Desktop |
| Kopfzeile | cfgmgr32.h (include Cfgmgr32.h) |
| Bibliothek | Cfgmgr32.lib |