WdfDeviceSetDeviceInterfaceState 함수(wdfdevice.h)

[KMDF 및 UMDF에 적용]

WdfDeviceSetDeviceInterfaceState 메서드는 지정된 디바이스에 대한 디바이스 인터페이스를 사용하거나 사용하지 않도록 설정합니다.

참고

드라이버는 디바이스가 시작된 후에만 이 함수를 호출해야 합니다. 디바이스 추가에서 인터페이스 상태를 변경하려면 대신 WdfDeviceSetDeviceInterfaceStateEx 를 호출합니다.

구문

void WdfDeviceSetDeviceInterfaceState(
  [in]           WDFDEVICE        Device,
  [in]           const GUID       *InterfaceClassGUID,
  [in, optional] PCUNICODE_STRING ReferenceString,
  [in]           BOOLEAN          IsInterfaceEnabled
);

매개 변수

[in] Device

프레임워크 디바이스 개체에 대한 핸들입니다.

[in] InterfaceClassGUID

디바이스 인터페이스 클래스를 식별하는 GUID에 대한 포인터입니다.

[in, optional] ReferenceString

디바이스 인터페이스에 대한 참조 문자열을 설명하는 UNICODE_STRING 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.

[in] IsInterfaceEnabled

TRUE인 경우 지정된 디바이스 인터페이스를 instance 사용하도록 설정하거나 FALSE인 경우 사용하지 않도록 설정하는 부울 값입니다.

반환 값

없음

설명

드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.

디바이스 인터페이스 및 WdfDeviceSetDeviceInterfaceState 메서드에 대한 자세한 내용은 디바이스 인터페이스 사용을 참조하세요.

예제

다음 코드 예제에서는 드라이버의 COM 포트 인터페이스를 사용하지 않도록 설정합니다.

WdfDeviceSetDeviceInterfaceState (
                                  Device,
                                  (LPGUID) &GUID_DEVINTERFACE_COMPORT,
                                  NULL,
                                  FALSE
                                  );

요구 사항

요구 사항	값
대상 플랫폼	유니버설
최소 KMDF 버전	1.0
최소 UMDF 버전	2.0
머리글	wdfdevice.h(Wdf.h 포함)
라이브러리	Wdf01000.sys(KMDF); WUDFx02000.dll(UMDF)
IRQL	PASSIVE_LEVEL
DDI 규정 준수 규칙	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

추가 정보

UNICODE_STRING

WdfDeviceCreateDeviceInterfaceWdfDeviceSetDeviceInterfaceStateEx