다음을 통해 공유


SetupDiEnumDriverInfoW 함수(setupapi.h)

SetupDiEnumDriverInfo 함수는 드라이버 목록의 멤버를 열거합니다.

통사론

WINSETUPAPI BOOL SetupDiEnumDriverInfoW(
  [in]           HDEVINFO           DeviceInfoSet,
  [in, optional] PSP_DEVINFO_DATA   DeviceInfoData,
  [in]           DWORD              DriverType,
  [in]           DWORD              MemberIndex,
  [out]          PSP_DRVINFO_DATA_W DriverInfoData
);

매개 변수

[in] DeviceInfoSet

열거할 드라이버 목록이 포함된 디바이스 정보 집합에 대한 핸들입니다.

[in, optional] DeviceInfoData

DeviceInfoSet디바이스 정보 요소를 지정하는 SP_DEVINFO_DATA 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL수 있습니다. 이 매개 변수를 지정하면 SetupDiEnumDriverInfo 지정된 디바이스에 대한 드라이버 목록을 열거합니다. 이 매개 변수가 NULL경우 SetupDiEnumDriverInfo DeviceInfoSet 연결된 전역 클래스 드라이버 목록을 열거합니다(이 목록은 SPDIT_CLASSDRIVER 형식임).

[in] DriverType

열거할 드라이버 목록의 형식이며 다음 값 중 하나여야 합니다.

SPDIT_CLASSDRIVER

클래스 드라이버 목록을 열거합니다. deviceInfoData 지정하지 않은 경우 이 드라이버 목록 유형을 지정해야 합니다.

SPDIT_COMPATDRIVER

지정된 디바이스에 대해 호환되는 드라이버 목록을 열거합니다. 이 드라이버 목록 형식은 DeviceInfoData 지정한 경우에만 지정할 수 있습니다.

[in] MemberIndex

검색할 드라이버 정보 멤버의 인덱스(0부터 시작하는 인덱스)입니다.

[out] DriverInfoData

열거형 드라이버에 대한 정보를 수신하는 호출자 초기화된 SP_DRVINFO_DATA 구조체에 대한 포인터입니다. 호출자는 DriverInfoData를 설정해야 합니다. SetupDiEnumDriverInfo호출하기 전에 cbSize sizeof(SP_DRVINFO_DATA). cbSize 멤버가 제대로 설정되지 않은 경우 setupDiEnumDriverInfo FALSE반환합니다.

반환 값

함수는 성공하면 TRUE 반환합니다. 그렇지 않으면 FALSE 반환되며, GetLastError호출하여 기록된 오류를 검색할 수 있습니다.

발언

드라이버 정보 집합 멤버를 열거하려면 설치 관리자가 먼저 MemberIndex 매개 변수가 0으로 설정된 SetupDiEnumDriverInfo 호출해야 합니다. 그런 다음 MemberIndex 증가시키고 값이 더 이상 없을 때까지 SetupDiEnumDriverInfo 호출해야 합니다. 값이 더 이상 없으면 함수가 실패하고 GetLastError 호출하면 ERROR_NO_MORE_ITEMS 반환됩니다.

driverInfoData포인터에서 제공하는 SP_DRVINFO_DATA 구조체의 cbSize 멤버를 제대로 초기화하지 않으면 함수가 실패하고 오류 ERROR_INVALID_USER_BUFFER 기록합니다.

특정 디바이스 또는 디바이스 정보 집합에 대한 전역 클래스 드라이버 목록과 연결된 드라이버 목록을 빌드하려면 먼저 setupDiBuildDriverInfoList 다음 해당 목록을 SetupDiEnumDriverInfo전달합니다.

메모

setupapi.h 헤더는 SETUPDiEnumDriverInfo를 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

요구
지원되는 최소 클라이언트 Microsoft Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼 바탕 화면
헤더 setupapi.h(Setupapi.h 포함)
라이브러리 Setupapi.lib

참고 항목

SetupDiBuildDriverInfoList