SetupDiCreateDeviceInterfaceA 함수(setupapi.h)
SetupDiCreateDeviceInterface 함수는 로컬 시스템 또는 원격 시스템에 디바이스 인터페이스를 등록합니다.
통사론
WINSETUPAPI BOOL SetupDiCreateDeviceInterfaceA(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVINFO_DATA DeviceInfoData,
[in] const GUID *InterfaceClassGuid,
[in, optional] PCSTR ReferenceString,
[in] DWORD CreationFlags,
[out, optional] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData
);
매개 변수
[in] DeviceInfoSet
디바이스 정보 집합에 대한 핸들은. 이 집합에는 인터페이스를 등록할 디바이스를 나타내는 디바이스 정보 요소가 포함되어 있습니다. 이 핸들은 일반적으로 SetupDiGetClassDevs반환됩니다.
[in] DeviceInfoData
DeviceInfoSet디바이스 정보 요소를 지정하는 SP_DEVINFO_DATA 구조체에 대한 포인터입니다.
[in] InterfaceClassGuid
새 인터페이스의 인터페이스 클래스를 지정하는 클래스 GUID에 대한 포인터입니다.
[in, optional] ReferenceString
참조 문자열을 제공하는 NULL로 끝나는 문자열에 대한 포인터입니다. 이 포인터는 선택 사항이며 NULL
[in] CreationFlags
예약. 0이어야 합니다.
[out, optional] DeviceInterfaceData
새 디바이스 인터페이스에 대한 정보를 수신하기 위해 호출자가 초기화한 SP_DEVICE_INTERFACE_DATA 구조체에 대한 포인터입니다. 이 포인터는 선택 사항이며 NULL
반환 값
SetupDiCreateDeviceInterface 함수가 오류 없이 완료되면 TRUE 반환합니다. 함수가 오류로 완료된 경우 FALSE 반환하고 GetLastError호출하여 오류에 대한 오류 코드를 검색할 수 있습니다.
발언
이 함수의 호출자는 Administrators 그룹의 구성원이어야 합니다.
SetupDiCreateDeviceInterface 디바이스에 대한 인터페이스를 등록합니다. 디바이스에 둘 이상의 인터페이스가 있는 경우 등록되는 각 인터페이스에 대해 이 함수를 한 번 호출합니다.
이 함수는 지정된 디바이스 정보 요소에 해당하는 디바이스에 대한 인터페이스를 성공적으로 등록하는 경우 지정된 디바이스 정보 집합의 디바이스 정보 요소와 연결된 인터페이스 목록에도 인터페이스를 추가합니다.
애플리케이션 및 기타 시스템 구성 요소에서 등록된 인터페이스를 사용하려면 먼저 드라이버가 디바이스에 대해 인터페이스를 사용하도록 설정해야 합니다.
이 함수는 새 디바이스 인터페이스에 대한 레지스트리 키를 만듭니다. 이 함수의 호출자는 SetupDiOpenDeviceInterfaceRegKey사용하여 이 키 아래의 비휘발성 스토리지에 액세스할 수 있습니다.
메모
setupapi.h 헤더는 SETUPDiCreateDeviceInterface를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Microsoft Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다. |
| 대상 플랫폼 | 바탕 화면 |
| 헤더 | setupapi.h(Setupapi.h 포함) |
| 라이브러리 | Setupapi.lib |
참고 항목
setupDiOpenDeviceInterfaceRegKey