SetupDiGetDeviceInterfacePropertyKeys 함수(setupapi.h)

  • 아티클

SetupDiGetDeviceInterfacePropertyKeys 함수는 디바이스 인터페이스에 대해 설정된 디바이스 속성을 나타내는 디바이스 속성 키 배열을 검색합니다.

구문

WINSETUPAPI BOOL SetupDiGetDeviceInterfacePropertyKeys(
  [in]            HDEVINFO                  DeviceInfoSet,
  [in]            PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
  [out, optional] DEVPROPKEY                *PropertyKeyArray,
  [in]            DWORD                     PropertyKeyCount,
  [out, optional] PDWORD                    RequiredPropertyKeyCount,
  [in]            DWORD                     Flags
);

매개 변수

[in] DeviceInfoSet

디바이스 정보 집합에 대한 핸들입니다. 이 디바이스 정보 집합에는 디바이스 인터페이스에 대해 설정된 디바이스 속성을 나타내는 디바이스 속성 키의 배열을 검색하는 디바이스 인터페이스가 포함되어 있습니다.

[in] DeviceInterfaceData

디바이스 속성 키의 요청된 배열을 검색할 디바이스 인터페이스를 나타내는 SP_DEVICE_INTERFACE_DATA 구조체에 대한 포인터입니다.

[out, optional] PropertyKeyArray

각 값이 디바이스 인터페이스에 대해 설정된 디바이스 속성의 디바이스 속성 키인 DEVPROPKEY 형식 값 배열을 수신하는 버퍼에 대한 포인터입니다. 포인터는 선택 사항이며 NULL일 수 있습니다. 자세한 내용은 이 항목의 뒷부 분에 있는 설명 섹션을 참조하세요.

[in] PropertyKeyCount

PropertyKeyArray 버퍼의 DEVPROPKEY 형식 요소 크기입니다. PropertyKeyArray가 NULL이면 PropertyKeyCount를 0으로 설정해야 합니다.

[out, optional] RequiredPropertyKeyCount

요청된 디바이스 속성 키 수를 수신하는 DWORD 형식 변수에 대한 포인터입니다. 포인터는 선택 사항이며 NULL로 설정할 수 있습니다.

[in] Flags

이 매개 변수는 0으로 설정해야 합니다.

반환 값

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

다음 표에는 이 함수가 기록할 수 있는 몇 가지 일반적인 오류 코드가 포함되어 있습니다.

반환 코드 설명
ERROR_INVALID_FLAGS
 Flags 값이 0이 아닙니다.
ERROR_INVALID_HANDLE
 DevInfoSet에서 지정한 디바이스 정보 집합이 잘못되었습니다.
ERROR_INVALID_DATA
 내부 데이터 값이 잘못되었습니다.
ERROR_INVALID_PARAMETER
 매개 변수가 잘못된 경우 한 가지 가능성은 DevInterfaceData 에서 지정한 디바이스 인터페이스가 유효하지 않다는 것입니다.
ERROR_INVALID_USER_BUFFER
 사용자 버퍼가 잘못되었습니다. 한 가지 가능성은 PropertyKeyArray 가 NULL이고 PropertKeyCount 가 0이 아니라는 것입니다. .
ERROR_NO_SUCH_DEVICE_INTERFACE
 DeviceInterfaceData로 지정된 디바이스 인터페이스가 없습니다.
ERROR_INSUFFICIENT_BUFFER
 PropertyKeyArray 버퍼가 요청된 모든 속성 키를 보유할 만큼 크지 않습니다.
ERROR_NOT_ENOUGH_MEMORY
 작업을 완료하는 데 사용할 수 있는 시스템 메모리가 부족했습니다.

설명

SetupDiGetDeviceInterfacePropertyKeys 는 통합 디바이스 속성 모델의 일부입니다.

PropertyKeyArray 버퍼가 요청된 모든 속성 키를 보유할 만큼 크지 않은 경우 SetupDiGetDeviceInterfacePropertyKeys는 속성 키를 검색하지 않고 ERROR_INSUFFICIENT_BUFFER 반환합니다. 호출자가 RequiredPropertyKeyCount 포인터를 제공한 경우 SetupDiGetDeviceInterfacePropertyKeys 는 *RequiredPropertyKeyCount 값을 PropertyKeyArray 버퍼의 DEVPROPKEY 형식 값으로 필요한 크기로 설정합니다.

디바이스 인터페이스 속성을 검색하려면 SetupDiGetDeviceInterfaceProperty를 호출하고 디바이스 인터페이스 속성을 설정하려면 SetupDiSetDeviceInterfaceProperty를 호출합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista 및 이후 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼 DesktopFor universal, call CM_Get_Device_Interface_Property_Keys
머리글 setupapi.h(Setupapi.h 포함)
라이브러리 Setupapi.lib
DLL Setupapi.dll

추가 정보

SetupDiGetDeviceInterfaceProperty

SetupDiSetDeviceInterfaceProperty