WdfDeviceSetDeviceState 함수(wdfdevice.h)

  • 아티클

[KMDF 및 UMDF에 적용]

WdfDeviceSetDeviceState 메서드는 지정된 디바이스의 디바이스 상태를 설정합니다.

구문

void WdfDeviceSetDeviceState(
  [in] WDFDEVICE         Device,
  [in] PWDF_DEVICE_STATE DeviceState
);

매개 변수

[in] Device

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

[in] DeviceState

디바이스의 상태 정보를 포함하는 드라이버 할당 WDF_DEVICE_STATE 구조체에 대한 포인터입니다.

반환 값

없음

설명

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

드라이버가 WdfDeviceSetDeviceState를 호출하면 프레임워크는 플러그 앤 플레이(PnP) 관리자에게 디바이스 상태가 변경되었음을 알 수 있습니다.

예제

다음 코드 예제에서는 PnP 관리자에게 지정된 디바이스가 비활성화되었음을 알릴 수 있습니다.

WDF_DEVICE_STATE    deviceState;

WDF_DEVICE_STATE_INIT (&deviceState);
deviceState.Disabled = WdfTrue;
WdfDeviceSetDeviceState (
                         Device,
                         &deviceState
                         );

요구 사항

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

추가 정보

WDF_DEVICE_STATE_INIT