SwDeviceInterfaceSetState 함수(swdevice.h)

소프트웨어 디바이스에 대한 디바이스 인터페이스를 사용하거나 사용하지 않도록 설정합니다.

구문

HRESULT SwDeviceInterfaceSetState(
  [in] HSWDEVICE hSwDevice,
  [in] PCWSTR    pszDeviceInterfaceId,
  [in] BOOL      fEnabled
);

매개 변수

[in] hSwDevice

디바이스 인터페이스를 등록할 소프트웨어 디바이스에 대한 HSWDEVICE 핸들입니다.

[in] pszDeviceInterfaceId

사용하거나 사용하지 않도록 설정할 인터페이스를 식별하는 문자열입니다.

[in] fEnabled

인터페이스를 사용하거나 사용하지 않도록 설정할지 여부를 나타내는 부울 값입니다. TRUE 를 사용하도록 설정하려면 이고, FALSE 를 사용하여 사용하지 않도록 설정합니다.

반환 값

swDeviceInterfaceSetState가 인터페이스를 성공적으로 사용하거나 사용하지 않도록 설정한 경우 S_OK 반환됩니다. 그렇지 않으면 적절한 오류 값입니다.

설명

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

SwDeviceInterfaceSetState만 사용하여 hSwDevice가 나타내는 소프트웨어 디바이스에 대해 이전에 SwDeviceInterfaceRegister에 등록된 인터페이스를 관리할 수 있습니다.

클라이언트 앱 은 SwDeviceInterfaceSetState 를 사용하여 인터페이스에 사용할 상태를 관리합니다. 소프트웨어 디바이스는 필요에 따라 실제 인터페이스 상태를 변경합니다. 예를 들어 클라이언트 앱은 어떤 이유로든 디바이스가 다시 열거되는 경우 인터페이스를 사용하지 않도록 설정하고 다시 사용하도록 설정합니다. 상태는 항상 클라이언트 앱의 필수 상태를 반영하려고 합니다.

요구 사항

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