WDF_DEVICE_STATE 구조체(wdfdevice.h)

[KMDF 및 UMDF에 적용]

WDF_DEVICE_STATE 구조체는 디바이스의 플러그 앤 플레이 상태를 지정합니다.

구문

typedef struct _WDF_DEVICE_STATE {
  ULONG         Size;
  WDF_TRI_STATE Disabled;
  WDF_TRI_STATE DontDisplayInUI;
  WDF_TRI_STATE Failed;
  WDF_TRI_STATE NotDisableable;
  WDF_TRI_STATE Removed;
  WDF_TRI_STATE ResourcesChanged;
  WDF_TRI_STATE AssignedToGuest;
} WDF_DEVICE_STATE, *PWDF_DEVICE_STATE;

멤버

Size

이 구조체의 크기(바이트)입니다.

Disabled

WdfTrue로 설정된 경우 디바이스가 비활성화되었음을 나타내는 WDF_TRI_STATE 형식의 값입니다. WDF_TRI_STATE 형식에 대한 자세한 내용은 다음 설명 섹션을 참조하세요.

DontDisplayInUI

WdfTrue로 설정된 경우 디바이스가 장치 관리자 숨겨져 있음을 나타내는 WDF_TRI_STATE 형식의 값입니다. 자세한 내용은 숨겨진 디바이스 보기를 참조하세요. (이 멤버를 WdfTrue로 설정한 후에는 해당 값을 변경해도 아무런 효과가 없습니다.)

Failed

WdfTrue로 설정된 경우 디바이스가 있지만 실패했음을 나타내는 WDF_TRI_STATE 형식의 값입니다.

NotDisableable

WdfTrue로 설정된 경우 디바이스를 사용하지 않도록 설정할 수 없음을 나타내는 WDF_TRI_STATE 형식의 값입니다.

Removed

WdfTrue로 설정된 경우 디바이스가 제거되었음을 나타내는 WDF_TRI_STATE 형식의 값입니다.

ResourcesChanged

WdfTrue로 설정된 경우 디바이스의 리소스 요구 사항이 변경되었음을 나타내는 WDF_TRI_STATE 형식의 값입니다.

AssignedToGuest

WdfTrue로 설정된 경우 디바이스가 게스트 파티션에 할당된 것으로 보고하고 있음을 나타내는 WDF_TRI_STATE 형식의 값입니다.

설명

구조체 멤버는 WDF_TRI_STATE 형식을 사용합니다. WdfUseDefault 값은 프레임워크가 스택의 하위 드라이버에서 제공한 값을 사용한다는 것을 나타냅니다. 예를 들어 버스 드라이버가 NotDisable에 대해 WdfTrue를 지정하고 디바이스의 함수 드라이버가 WdfUseDefault를 지정하는 경우 프레임워크는 디바이스 상태에 WdfTrue를 사용합니다.

WDF_DEVICE_STATE 구조체는 WdfDeviceSetDeviceState 및 WdfDeviceGetDeviceState에 대한 매개 변수로 사용됩니다.

WDF_DEVICE_STATE 구조를 초기화하려면 드라이버가 WDF_DEVICE_STATE_INIT 호출해야 합니다.

WDF_DEVICE_STATE 구조체의 멤버에 대한 자세한 내용은 PNP_DEVICE_STATE 참조하세요.

요구 사항

요구 사항	값
최소 KMDF 버전	1.0
최소 UMDF 버전	2.0
머리글	wdfdevice.h(Wdf.h 포함)