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) |