SwDevicePropertySet 함수(swdevice.h)

소프트웨어 디바이스에서 속성을 설정합니다.

구문

HRESULT SwDevicePropertySet(
  [in] HSWDEVICE         hSwDevice,
  [in] ULONG             cPropertyCount,
  [in] const DEVPROPERTY *pProperties
);

매개 변수

[in] hSwDevice

속성을 설정할 소프트웨어 디바이스에 대한 HSWDEVICE 핸들입니다.

[in] cPropertyCount

pProperties 배열의 DEVPROPERTY 구조체 수입니다.

[in] pProperties

설정할 속성을 포함하는 DEVPROPERTY 구조체의 배열입니다.

반환 값

swDevicePropertySet이 속성을 성공적으로 설정하면 S_OK 반환됩니다. 그렇지 않으면 적절한 오류 값입니다.

설명

일반적으로 컴퓨터의 운영 체제 및 관리자만 디바이스에서 속성을 설정할 수 있지만 디바이스 작성자는 SwDevicePropertySet 을 호출하여 운영 체제 또는 관리자가 아니더라도 해당 디바이스에서 속성을 설정할 수 있습니다.

운영 체제가 클라이언트 앱의 SW_DEVICE_CREATE_CALLBACK 콜백 함수를 호출한 후에만 SwDevicePropertySet을 호출하여 클라이언트 앱에 디바이스 열거가 완료되었음을 알릴 수 있습니다.

SwDeviceCreate 호출의 일부로 설정된 속성과 SwDevicePropertySet을 호출하여 나중에 설정되는 속성 간에는 미묘한 차이가 있습니다. SwDeviceCreate의 일부로 설정된 속성은 메모리에 저장됩니다. 디바이스가 제거되거나 null 드라이버가 속성 저장소를 초기화하면 PnP가 디바이스를 다시 열거할 때 소프트웨어 디바이스 API 기능에 의해 이러한 속성이 다시 기록됩니다. 이는 모두 클라이언트에 투명합니다. 열거 후 SwDevicePropertySet 을 사용하여 설정된 속성은 메모리에 유지되지 않습니다. 그러나 SwDeviceCreate를 사용하여 속성을 설정하는 경우 SwDevicePropertySet을 사용하여 값을 업데이트할 수 있으며 이 업데이트는 메모리 내 값과 지속형 저장소에 적용됩니다.

SwDevicePropertySet만 사용하여 디바이스에 대한 운영 체제 저장소의 속성을 설정할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 8
지원되는 최소 서버	Windows Server 2012
대상 플랫폼	유니버설
헤더	swdevice.h
라이브러리	Swdevice.lib; Windows 10 OneCoreUAP.lib
DLL	Cfgmgr32.dll