SetupDiEnumDeviceInfo 함수(setupapi.h)

아티클
08/26/2023

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에 도입됨)