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
[out, optional] ppszDeviceInterfaceId
인터페이스의 디바이스 인터페이스 ID에 대한 포인터를 받는 변수에 대한 포인터입니다. 호출자는 swMemFree
반환 값
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 |