SwDeviceInterfaceRegister 함수(swdevice.h)

소프트웨어 디바이스에 대한 디바이스 인터페이스를 등록하고 필요에 따라 해당 인터페이스의 속성을 설정합니다.

구문

HRESULT SwDeviceInterfaceRegister(
  [in]            HSWDEVICE         hSwDevice,
  [in]            const GUID        *pInterfaceClassGuid,
  [in, optional]  PCWSTR            pszReferenceString,
  [in]            ULONG             cPropertyCount,
  [in, optional]  const DEVPROPERTY *pProperties,
  [in]            BOOL              fEnabled,
  [out, optional] PWSTR             *ppszDeviceInterfaceId
);

매개 변수

[in] hSwDevice

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

[in] pInterfaceClassGuid

이 인터페이스가 구현하는 계약의 이름을 지정하는 인터페이스 클래스 GUID에 대한 포인터입니다.

[in, optional] pszReferenceString

이 디바이스에 대해 동일한 클래스의 여러 인터페이스를 구분하는 선택적 참조 문자열입니다. 이 포인터는 NULL일 수 있습니다.

[in] cPropertyCount

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

[in, optional] pProperties

인터페이스에서 설정할 속성에 대한 DEVPROPERTY 구조체의 선택적 배열입니다. 이 포인터는 NULL일 수 있습니다.

인터페이스를 만든 후 인터페이스가 생성되었다는 알림이 전송되기 전에 인터페이스에서 이러한 속성을 설정합니다. 자세한 내용은 비고를 참조하세요. 이 포인터는 NULL일 수 있습니다.

[in] fEnabled

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

[out, optional] ppszDeviceInterfaceId

인터페이스의 디바이스 인터페이스 ID에 대한 포인터를 수신하는 변수에 대한 포인터입니다. 호출자는 SwMemFree를 사용하여 이 값을 해제해야 합니다. 클라이언트 앱이 이름을 검색할 필요가 없는 경우 이 값은 NULL 일 수 있습니다.

반환 값

swDeviceInterfaceRegister가 인터페이스를 성공적으로 등록하면 S_OK 반환됩니다. 그렇지 않으면 적절한 오류 값입니다.

설명

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

SWDeviceCapabilitiesDriverRequired 기능을 지정하는 소프트웨어 디바이스의 경우 SwDeviceInterfaceRegister를 호출할 수 없습니다.

요구 사항

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

추가 정보

SwMemFree