Wie Geräte mit SetupDi aufrufen

Zusammenfassung

Eine Liste der installierten Geräte unter Windows NT und höher können Clientanwendungen SetupDi Klasse von API-Funktionen verwenden.

Weitere Informationen

Im folgenden Codefragment wird veranschaulicht, wie eine Liste aller installierten Hardwaregeräte angezeigt werden kann:

   #include <stdio.h>   #include <windows.h>
#include <setupapi.h>
#include <devguid.h>
#include <regstr.h>

int main( int argc, char *argv[ ], char *envp[ ] )
{
HDEVINFO hDevInfo;
SP_DEVINFO_DATA DeviceInfoData;
DWORD i;

// Create a HDEVINFO with all present devices.
hDevInfo = SetupDiGetClassDevs(NULL,
0, // Enumerator
0,
DIGCF_PRESENT | DIGCF_ALLCLASSES );

if (hDevInfo == INVALID_HANDLE_VALUE)
{
// Insert error handling here.
return 1;
}

// Enumerate through all devices in Set.

DeviceInfoData.cbSize = sizeof(SP_DEVINFO_DATA);
for (i=0;SetupDiEnumDeviceInfo(hDevInfo,i,
&DeviceInfoData);i++)
{
DWORD DataT;
LPTSTR buffer = NULL;
DWORD buffersize = 0;

//
// Call function with null to begin with,
// then use the returned buffer size (doubled)
// to Alloc the buffer. Keep calling until
// success or an unknown failure.
//
// Double the returned buffersize to correct
// for underlying legacy CM functions that
// return an incorrect buffersize value on
// DBCS/MBCS systems.
//
while (!SetupDiGetDeviceRegistryProperty(
hDevInfo,
&DeviceInfoData,
SPDRP_DEVICEDESC,
&DataT,
(PBYTE)buffer,
buffersize,
&buffersize))
{
if (GetLastError() ==
ERROR_INSUFFICIENT_BUFFER)
{
// Change the buffer size.
if (buffer) LocalFree(buffer);
// Double the size to avoid problems on
// W2k MBCS systems per KB 888609.
buffer = LocalAlloc(LPTR,buffersize * 2);
}
else
{
// Insert error handling here.
break;
}
}

printf("Result:[%s]\n",buffer);

if (buffer) LocalFree(buffer);
}


if ( GetLastError()!=NO_ERROR &&
GetLastError()!=ERROR_NO_MORE_ITEMS )
{
// Insert error handling here.
return 1;
}

// Cleanup
SetupDiDestroyDeviceInfoList(hDevInfo);

return 0;
}

Hinweis Die SetupDiGetDeviceRegistryProperty -Funktion gibt ein falscher Wert RequiredSize auf Mehrbyte-Zeichensätzen (MBCS) Systeme festgelegt, die Microsoft Windows 2000 ausgeführt werden. Der Beispielcode in diesem Artikel umgeht dieses Problem durch die Verdopplung des RequiredSize -Werts enthalten.

Das folgende Codefragment veranschaulicht das Abrufen aller Geräte auf dem Bus Peripheral Component Interconnect (PCI).
    hDevInfo = SetupDiGetClassDevs(NULL,        REGSTR_KEY_PCIENUM, // Enumerator
0,
DIGCF_PRESENT | DIGCF_ALLCLASSES );

Windows-API-Funktionen, die ein Gerät Instanz behandeln, wie der Konfigurations-Manager-API-Funktionen erfordern können DevInst Wert in der Struktur SP_DEVINFO_DATA zurückgegeben, die von der Funktion SetupDiEnumDeviceInfo: Es konnten .

Referenzen

SetupDi API-Aufrufe sind in Device Development Kit (DDK) dokumentiert. Beispielcode Aufzählung arbeiten, finden Sie im Beispielcode DevCon DDK (Src\setup\devcon).
Eigenschaften

Artikelnummer: 259695 – Letzte Überarbeitung: 08.01.2017 – Revision: 1

Feedback