SetupDiSetSelectedDriverA 함수(setupapi.h)

  • 아티클

SetupDiSetSelectedDriver 함수는 디바이스 정보 요소에 대해 선택한 드라이버 또는 디바이스 정보 집합에 대해 선택한 클래스 드라이버를 설정하거나 다시 설정합니다.

구문

WINSETUPAPI BOOL SetupDiSetSelectedDriverA(
  [in]      HDEVINFO           DeviceInfoSet,
  [in, out] PSP_DEVINFO_DATA   DeviceInfoData,
  [in, out] PSP_DRVINFO_DATA_A DriverInfoData
);

매개 변수

[in] DeviceInfoSet

디바이스 정보 요소 또는 디바이스 정보 집합 에 대한 드라이버를 선택할 드라이버 목록이 포함된 디바이스 정보 집합에 대한 핸들입니다.

[in, out] DeviceInfoData

DeviceInfoSet에서 디바이스 정보 요소를 지정하는 SP_DEVINFO_DATA 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다. 이 매개 변수를 지정하면 SetupDiSetSelectedDriver 가 지정된 디바이스에 대해 선택한 드라이버를 설정하거나 다시 설정합니다. 이 매개 변수가 NULL인 경우 SetupDiSetSelectedDriver 는 DeviceInfoSet에 대해 선택한 클래스 드라이버를 설정하거나 다시 설정합니다.

[in, out] DriverInfoData

선택할 드라이버를 지정하는 SP_DRVINFO_DATA 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다. 이 매개 변수와 DeviceInfoData 를 제공하는 경우 지정된 드라이버는 DeviceInfoData와 연결된 드라이버 목록의 멤버여야 합니다. 이 매개 변수를 지정하고 DeviceInfoData 가 NULL인 경우 드라이버는 DeviceInfoSet에 대한 전역 클래스 드라이버 목록의 멤버여야 합니다. 이 매개 변수가 NULL이면 DeviceInfoData 가 지정된 경우 디바이스 정보 요소에 대해 선택한 드라이버가 다시 설정되거나 DeviceInfoData 가 NULL인 경우 디바이스 정보 집합이 다시 설정됩니다.

DriverInfoData인 경우예약된 은 NULL이고 호출자는 지정된 매개 변수(DriverType, Description 및 ProviderName)를 사용하여 드라이버 노드에 대한 검색을 요청합니다. 일치하는 항목이 발견되면 해당 드라이버 노드가 선택됩니다. 예약된 필드는 일치 항목이 발견된 실제 드라이버 노드를 반영하도록 출력에서 업데이트됩니다. 일치 항목을 찾을 수 없으면 함수가 실패하고 GetLastError 를 호출하면 ERROR_INVALID_PARAMETER 반환됩니다.

반환 값

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

설명

SetupDiSetSelectedDriver의 호출자가 Administrators 그룹의 구성원인 경우 두 클래스가 서로 다른 경우 디바이스의 클래스가 선택한 드라이버의 클래스로 설정됩니다.

DriverInfoData가 NULL인 경우 SetupDiSetSelectedDriver는 선택한 드라이버를 다시 설정합니다. 따라서 선택한 드라이버가 없습니다.

참고

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

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Microsoft Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼 데스크톱
머리글 setupapi.h(Setupapi.h 포함)
라이브러리 Setupapi.lib

추가 정보

SetupDiGetSelectedDriver