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 값은 프레임워크가 스택의 하위 드라이버에서 제공한 값을 사용한다는 것을 나타냅니다. 예를 들어 버스 드라이버가 NotDisableWdfTrue 지정하고 디바이스의 함수 드라이버가 WdfUseDefault지정하는 경우 프레임워크는 디바이스 상태에 WdfTrue 사용합니다.

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

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

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

요구 사항