SetupDiEnumDeviceInfo 함수(setupapi.h)
SetupDiEnumDeviceInfo 함수는 디바이스 정보 집합의 디바이스 정보 요소를 지정하는 SP_DEVINFO_DATA 구조를 반환합니다.
구문
WINSETUPAPI BOOL SetupDiEnumDeviceInfo(
[in] HDEVINFO DeviceInfoSet,
[in] DWORD MemberIndex,
[out] PSP_DEVINFO_DATA DeviceInfoData
);
매개 변수
[in] DeviceInfoSet
디바이스 정보 요소를 나타내는 SP_DEVINFO_DATA 구조를 반환할 디바이스 정보 집합에 대한 핸들입니다.
[in] MemberIndex
검색할 디바이스 정보 요소의 인덱스(0부터 시작)입니다.
[out] DeviceInfoData
열거된 디바이스 정보 요소에 대한 정보를 수신하는 SP_DEVINFO_DATA 구조체에 대한 포인터입니다. 호출자는 DeviceInfoData를 설정해야 합니다. cbSize 를 로 지정합니다 sizeof(SP_DEVINFO_DATA).
반환 값
함수가 성공하면 TRUE 를 반환합니다. 그렇지 않으면 FALSE 를 반환하고 GetLastError를 호출하여 기록된 오류를 검색할 수 있습니다.
설명
이 함수에 대한 반복 호출은 다른 디바이스에 대한 디바이스 정보 요소를 반환합니다. 이 함수를 반복적으로 호출하여 디바이스 정보 집합의 모든 디바이스에 대한 정보를 가져올 수 있습니다.
디바이스 정보 요소를 열거하려면 설치 관리자가 처음에 MemberIndex 매개 변수를 0으로 설정하여 SetupDiEnumDeviceInfo를 호출해야 합니다. 그런 다음, 설치 관리자는 더 이상 값이 없을 때까지 MemberIndex 를 증가시키고 SetupDiEnumDeviceInfo 를 호출해야 합니다(함수가 실패하고 GetLastError 를 호출하면 ERROR_NO_MORE_ITEMS 반환됨).
SetupDiEnumDeviceInterfaces를 호출하여 디바이스 인터페이스 요소(디바이스 정보 요소와 비교)에 대한 컨텍스트 구조를 가져옵니다.
요구 사항
| 지원되는 최소 클라이언트 | Microsoft Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다. |
| 대상 플랫폼 | 데스크톱 |
| 머리글 | setupapi.h(Setupapi.h 포함) |
| 라이브러리 | Setupapi.lib |
| DLL | Setupapi.dll |
| API 세트 | ext-ms-win-setupapi-classinstallers-l1-1-0(Windows 8에 도입됨) |