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 |
추가 정보
피드백
https://aka.ms/ContentUserFeedback을 참조하세요.
출시 예정: 2024년 내내 콘텐츠 피드백 메커니즘인 GitHub 문제를 단계적으로 폐지하고 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은다음에 대한 사용자 의견 제출 및 보기