IWDFDevice::AssignDeviceInterfaceState 메서드(wudfddi.h)
[경고: UMDF 2는 UMDF의 최신 버전이며 UMDF 1을 대체합니다. 모든 새 UMDF 드라이버는 UMDF 2를 사용하여 작성해야 합니다. UMDF 1에 새 기능이 추가되지 않으며 최신 버전의 Windows 10 UMDF 1에 대한 지원이 제한되어 있습니다. 유니버설 Windows 드라이버는 UMDF 2를 사용해야 합니다. 자세한 내용은 UMDF를 사용하여 시작 참조하세요.]
AssignDeviceInterfaceState 메서드는 디바이스에 대해 지정된 디바이스 인터페이스 instance 사용하거나 사용하지 않도록 설정합니다.
구문
HRESULT AssignDeviceInterfaceState(
[in] LPCGUID pDeviceInterfaceGuid,
[in, optional] PCWSTR pReferenceString,
[in] BOOL Enable
);
매개 변수
[in] pDeviceInterfaceGuid
디바이스 인터페이스 클래스의 GUID에 대한 포인터입니다.
[in, optional] pReferenceString
디바이스 인터페이스의 instance 이름을 포함하는 NULL로 끝나는 문자열에 대한 포인터입니다. 이 매개 변수는 선택적 요소입니다. 드라이버가 이름을 제공할 필요가 없는 경우 드라이버는 NULL 을 전달할 수 있습니다. 드라이버에서 이름을 제공해야 하는 경우 드라이버가 전달하는 문자열에는 경로 구분 기호 문자("/" 또는 "\")가 포함되어서는 안 됩니다.
[in] Enable
디바이스 인터페이스 instance 사용하도록 설정하거나 사용하지 않도록 설정할지 여부를 지정하는 BOOL 값입니다. TRUE 는 사용하도록 설정됨을 나타냅니다. FALSE 는 사용 안 함을 나타냅니다.
반환 값
AssignDeviceInterfaceState 는 작업이 성공하면 S_OK 반환합니다. 그렇지 않으면 이 메서드는 Winerror.h에 정의된 오류 코드 중 하나를 반환합니다.
설명
IWDFDevice::CreateDeviceInterface가 성공하면 프레임워크는 디바이스의 PnP 상태에 따라 인터페이스를 자동으로 사용하도록 설정하고 사용하지 않도록 설정합니다.
AssignDeviceInterfaceState 메서드를 사용하여 디바이스 인터페이스를 수동으로 사용하지 않도록 설정하고 다시 사용하도록 설정합니다.
디바이스 인터페이스에 대한 자세한 내용은 UMDF 드라이버에서 디바이스 인터페이스 사용을 참조하세요.
예제
AssignDeviceInterfaceState 메서드를 사용하는 방법에 대한 코드 예제는 IWDFDevice::CreateDeviceInterface를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원 종료 | UMDF 2.0 이상에서는 사용할 수 없습니다. |
| 대상 플랫폼 | 데스크톱 |
| 최소 UMDF 버전 | 1.5 |
| 머리글 | wudfddi.h(Wudfddi.h 포함) |
| DLL | WUDFx.dll |