CIM_USBDevice 클래스(CIMWin32 WMI 공급자)

아티클
06/13/2023

CIM_USBDevice 클래스는 USB 디바이스의 관리 특성을 나타냅니다.

중요

DMTF(분산 관리 태스크 포스) CIM(일반 정보 모델) 클래스는 WMI 클래스를 빌드하는 부모 클래스입니다. WMI는 현재 CIM 2.x 버전 스키마만 지원합니다.

다음 구문은 MOF(Managed Object Format) 코드를 단순화한 것으로 상속된 속성이 모두 포함되어 있습니다. 속성은 MOF 순서가 아닌 알파벳순으로 나열됩니다.

구문

[AMENDMENT]
class CIM_USBDevice : CIM_LogicalDevice
{
  uint16   Availability;
  string   Caption;
  uint8    ClassCode;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  uint8    CurrentAlternateSettings[];
  uint8    CurrentConfigValue;
  string   Description;
  string   DeviceID;
  boolean  ErrorCleared;
  string   ErrorDescription;
  datetime InstallDate;
  uint32   LastErrorCode;
  string   Name;
  uint8    NumberOfConfigs;
  string   PNPDeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  PowerManagementSupported;
  uint8    ProtocolCode;
  string   Status;
  uint16   StatusInfo;
  uint8    SubclassCode;
  string   SystemCreationClassName;
  string   SystemName;
  uint16   USBVersion;
};

멤버

CIM_USBDevice 클래스에는 다음과 같은 유형의 멤버가 있습니다.

메서드
속성

메서드

CIM_USBDevice 클래스에는 이러한 메서드가 있습니다.

메서드	설명
GetDescriptor	USB 디바이스 설명자를 반환합니다. WMI에서 구현되지 않습니다.
다시 설정	논리 디바이스의 초기화를 요청합니다. WMI에서 구현되지 않습니다.
SetPowerState	논리 디바이스에 대해 원하는 전원 상태와 디바이스를 해당 상태로 전환해야 하는 시기를 정의합니다. WMI에서 구현되지 않습니다.

속성

CIM_USBDevice 클래스에는 이러한 속성이 있습니다.

가용성

데이터 형식: uint16
액세스 형식: 읽기 전용
한정자: MappingStrings ("MIF. DMTF| 작동 상태|003.5", "MIB. IETF| HOST-RESOURCES-MIB.hrDeviceStatus")

디바이스의 가용성 및 상태.

이 속성은 CIM_LogicalDevice 상속됩니다.

기타 (1)

알 수 없음 (2)

실행 중/전체 전원 (3)

실행 중 또는 전체 전원

경고 (4)

테스트 중 (5)

해당 없음 (6)

전원 끄기 (7)

오프라인 (8)

오프 듀티 (9)

저하됨 (10)

설치되지 않음 (11)

설치 오류 (12)

절전 - 알 수 없음 (13)

디바이스는 절전 모드인 것으로 알려져 있지만 정확한 상태 알 수 없습니다.

절전 - 저전력 모드 (14)

디바이스가 절전 상태이지만 여전히 작동 중이며 성능이 저하될 수 있습니다.

절전 - 대기 (15)

디바이스가 작동하지 않지만 신속하게 전체 전원을 공급할 수 있습니다.

전원 주기 (16)

절전 - 경고 (17)

절전 모드에서도 디바이스가 경고 상태입니다.

일시 중지됨 (18)

디바이스가 일시 중지되었습니다.

준비되지 않음 (19)

디바이스가 준비되지 않았습니다.

구성되지 않음 (20)

장치가 구성되지 않았습니다.

정지됨 (21)

장치가 조용합니다.

캡션

데이터 형식: string
액세스 형식: 읽기 전용
한정자: MaxLen (64), DisplayName ("Caption")

개체에 대한 간단한 텍스트 설명입니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

ClassCode

데이터 형식: uint8
액세스 형식: 읽기 전용

USB 클래스 코드.

ConfigManagerErrorCode

데이터 형식: uint32
액세스 형식: 읽기 전용
한정자: 스키마 ("Win32")

Win32 Configuration Manager 오류 코드입니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

이 디바이스가 제대로 작동합니다. (0)

디바이스가 제대로 작동합니다.

이 디바이스가 올바르게 구성되지 않았습니다. (1)

디바이스가 올바르게 구성되지 않았습니다.

Windows에서 이 디바이스에 대한 드라이버를 로드할 수 없습니다. (2)

이 디바이스의 드라이버가 손상되었거나 시스템에서 메모리 또는 기타 리소스가 부족할 수 있습니다. (3)

이 디바이스의 드라이버가 손상되었거나 시스템이 메모리 또는 기타 리소스가 부족할 수 있습니다.

이 디바이스가 제대로 작동하지 않습니다. 드라이버 또는 레지스트리 중 하나가 손상되었을 수 있습니다. (4)

디바이스가 제대로 작동하지 않습니다. 드라이버 또는 레지스트리 중 하나가 손상되었을 수 있습니다.

이 디바이스의 드라이버에는 Windows에서 관리할 수 없는 리소스가 필요합니다. (5)

디바이스용 드라이버에는 Windows에서 관리할 수 없는 리소스가 필요합니다.

이 디바이스의 부팅 구성이 다른 디바이스와 충돌합니다. (6)

디바이스에 대한 부팅 구성이 다른 디바이스와 충돌합니다.

필터링할 수 없습니다. (7)

디바이스의 드라이버 로더가 없습니다. (8)

디바이스에 대한 드라이버 로더가 없습니다.

제어 펌웨어가 디바이스의 리소스를 잘못 보고하기 때문에 이 디바이스가 제대로 작동하지 않습니다. (9)

디바이스가 제대로 작동하지 않습니다. 제어 펌웨어가 디바이스의 리소스를 잘못 보고하고 있습니다.

이 디바이스를 시작할 수 없습니다. (10)

디바이스를 시작할 수 없습니다.

이 디바이스가 실패했습니다. (11)

디바이스가 실패했습니다.

이 디바이스는 사용할 수 있는 충분한 무료 리소스를 찾을 수 없습니다. (12)

디바이스에서 사용할 충분한 사용 가능한 리소스를 찾을 수 없습니다.

Windows에서 이 디바이스의 리소스를 확인할 수 없습니다. (13)

Windows에서 디바이스의 리소스를 확인할 수 없습니다.

컴퓨터를 다시 시작할 때까지 이 디바이스가 제대로 작동할 수 없습니다. (14)

컴퓨터를 다시 시작할 때까지 디바이스가 제대로 작동할 수 없습니다.

다시 열거형 문제가 있을 수 있으므로 이 디바이스가 제대로 작동하지 않습니다. (15)

가능한 다시 열거형 문제로 인해 디바이스가 제대로 작동하지 않습니다.

Windows는 이 디바이스에서 사용하는 모든 리소스를 식별할 수 없습니다. (16)

Windows는 디바이스에서 사용하는 모든 리소스를 식별할 수 없습니다.

이 디바이스는 알 수 없는 리소스 종류를 요구합니다. (17)

디바이스에서 알 수 없는 리소스 종류를 요청하고 있습니다.

이 디바이스에 대한 드라이버를 다시 설치합니다. (18)

디바이스 드라이버를 다시 설치해야 합니다.

VxD 로더를 사용하지 못했습니다. (19)

레지스트리가 손상되었을 수 있습니다. (20)

레지스트리가 손상되었을 수 있습니다.

시스템 오류: 이 디바이스의 드라이버를 변경해 보세요. 작동하지 않으면 하드웨어 설명서를 참조하세요. Windows에서 이 디바이스를 제거합니다. (21)

시스템 오류. 디바이스 드라이버를 변경하는 것이 비효율적인 경우 하드웨어 설명서를 참조하세요. Windows에서 디바이스를 제거합니다.

이 디바이스를 사용할 수 없습니다. (22)

디바이스를 사용할 수 없습니다.

시스템 오류: 이 디바이스의 드라이버를 변경해 보세요. 작동하지 않으면 하드웨어 설명서를 참조하세요. (23)

시스템 오류. 디바이스 드라이버를 변경하는 것이 비효율적인 경우 하드웨어 설명서를 참조하세요.

이 디바이스가 없거나, 제대로 작동하지 않거나, 모든 드라이버가 설치되어 있지 않습니다. (24)

디바이스가 없거나, 제대로 작동하지 않거나, 모든 드라이버가 설치되어 있지 않습니다.

Windows는 여전히 이 디바이스를 설정하고 있습니다. (25)

Windows는 여전히 디바이스를 설정하고 있습니다.

Windows는 여전히 이 디바이스를 설정하고 있습니다. (26)

Windows는 여전히 디바이스를 설정하고 있습니다.

이 디바이스에는 유효한 로그 구성이 없습니다. (27)

디바이스에 유효한 로그 구성이 없습니다.

이 디바이스의 드라이버가 설치되지 않았습니다. (28)

디바이스 드라이버가 설치되지 않았습니다.

디바이스의 펌웨어가 필요한 리소스를 제공하지 않았기 때문에 이 디바이스를 사용할 수 없습니다. (29)

디바이스를 사용할 수 없습니다. 디바이스 펌웨어가 필요한 리소스를 제공하지 않았습니다.

이 디바이스는 다른 디바이스에서 사용하는 IRQ(인터럽트 요청) 리소스를 사용하고 있습니다. (30)

디바이스가 다른 디바이스에서 사용하는 IRQ 리소스를 사용하고 있습니다.

Windows에서 이 디바이스에 필요한 드라이버를 로드할 수 없으므로 이 디바이스가 제대로 작동하지 않습니다. (31)

디바이스가 제대로 작동하지 않습니다. Windows에서 필요한 디바이스 드라이버를 로드할 수 없습니다.

ConfigManagerUserConfig

데이터 형식: boolean
액세스 형식: 읽기 전용
한정자: 스키마 ("Win32")

TRUE이면 디바이스에서 사용자 정의 구성을 사용하고 있습니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

CreationClassName

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: CIM_Key

instance 만드는 데 사용되는 클래스 또는 하위 클래스의 이름입니다. 클래스의 다른 키 속성과 함께 사용할 경우 이 속성을 사용하면 클래스 및 해당 하위 클래스의 모든 인스턴스를 고유하게 식별할 수 있습니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

CurrentAlternateSettings

데이터 형식: uint8 배열
액세스 형식: 읽기 전용
한정자: ModelCorrespondence ("CIM_USBDevice. CurrentConfigValue")

현재 선택한 구성의 각 인터페이스에 대한 USB 대체 설정( CurrentConfigValue 속성으로 표시됨). 이 배열에는 구성의 각 인터페이스에 대해 하나의 항목이 있습니다. CurrentConfigValue 속성의 값이 0이면 디바이스가 구성되지 않음을 나타내며 배열이 정의되지 않습니다. 이 옥텟 문자열을 구문 분석하는 방법에 대한 자세한 내용은 USB 사양을 참조하세요.

CurrentConfigValue

데이터 형식: uint8
액세스 형식: 읽기 전용
한정자: ModelCorrespondence ("CIM_USBDevice. CurrentAlternateSettings")

현재 디바이스에 대해 선택된 구성입니다. 값이 0이면 디바이스가 구성되지 않습니다.

설명

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: DisplayName ("Description")

개체에 대한 텍스트 설명입니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

DeviceID

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: CIM_Key

논리 디바이스의 이름을 고유하게 지정하기 위한 주소 또는 기타 식별 정보입니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

ErrorCleared

데이터 형식: boolean
액세스 형식: 읽기 전용

TRUE이면 LastErrorCode 속성에 보고된 오류가 이제 지워집니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

ErrorDescription

데이터 형식: string
액세스 형식: 읽기 전용

LastErrorCode 속성에 기록된 오류 및 수행할 수정 작업에 대한 정보를 제공하는 자유 형식 문자열입니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

InstallDate

데이터 형식: datetime
액세스 형식: 읽기 전용
한정자: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("설치 날짜")

개체가 설치된 날짜 및 시간입니다. 이 속성은 개체가 설치되었음을 나타내는 값이 필요하지 않습니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

LastErrorCode

데이터 형식: uint32
액세스 형식: 읽기 전용

논리 디바이스에서 보고한 마지막 오류 코드입니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

이름

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: DisplayName ("Name")

개체가 알려진 레이블입니다. 서브클래스를 사용하면 이 속성을 키 속성으로 재정의할 수 있습니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

NumberOfConfigs

데이터 형식: uint8
액세스 형식: 읽기 전용

디바이스에 대해 정의된 디바이스 구성 수입니다.

PNPDeviceID

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: 스키마 ("Win32")

Win32 플러그 앤 플레이 논리 디바이스의 디바이스 식별자입니다. 이 속성은 CIM_LogicalDevice 상속됩니다.

예: "*PNP030b"

PowerManagementCapabilities

데이터 형식: uint16 배열
액세스 형식: 읽기 전용

논리 디바이스의 특정 전원 관련 기능 배열입니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

알 수 없음 (0)

지원되지 않음 (1)

사용 안 함 (2)

사용 (3)

전원 관리 기능은 현재 사용하도록 설정되어 있지만 정확한 기능 집합을 알 수 없거나 정보를 사용할 수 없습니다.

절전 모드가 자동으로 입력됨 (4)

디바이스는 사용량 또는 기타 기준에 따라 전원 상태를 변경할 수 있습니다.

전원 상태 설정 가능 (5)

SetPowerState 메서드가 지원됩니다. 이 메서드는 부모 CIM_LogicalDevice 클래스에서 찾을 수 있으며 구현할 수 있습니다. 자세한 내용은 MOF(Managed Object Format) 클래스 디자인을 참조하세요.

지원되는 파워 사이클링 (6)

SetPowerState 메서드는 PowerState 매개 변수를 5(전원 주기)로 설정하여 호출할 수 있습니다.

시간 제한 전원 켜기 지원 됨(7)

SetPowerState 메서드는 PowerState 매개 변수를 5(전원 주기)로 설정하고 전원 켜기를 위해 특정 날짜 및 시간 또는 간격으로 설정된 시간을 사용하여 호출할 수 있습니다.

PowerManagementSupported

데이터 형식: boolean
액세스 형식: 읽기 전용

TRUE이면 디바이스는 전원 관리, 즉 절전 상태로 전환될 수 있습니다. FALSE이면 정수 값 1("지원되지 않음")이 PowerManagementCapabilities 배열의 유일한 항목이어야 합니다.

이 속성은 전원 관리 기능이 현재 활성화되어 있는지 또는 활성화되어 있는지 여부를 나타내지 않습니다. 자세한 내용은 PowerManagementCapabilities 배열을 참조하세요. 이 속성은 CIM_LogicalDevice 상속됩니다.

ProtocolCode

데이터 형식: uint8
액세스 형식: 읽기 전용

USB 프로토콜 코드.

상태

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: MaxLen (10), DisplayName ("상태")

개체의 현재 상태. 이 속성은 CIM_ManagedSystemElement 상속됩니다.

여기에는 다음 값이 포함됩니다.

확인 ("확인")

오류 ("오류")

저하됨 ("성능 저하")

알 수 없음 ("알 수 없음")

Pred Fail ("Pred Fail")

시작 ("시작")

중지 ("중지")

서비스 ("서비스")

스트레스( "스트레스")

NonRecover ("NonRecover")

연락처 없음 ("연락처 없음")

Lost Comm ("Lost Comm")

StatusInfo

데이터 형식: uint16
액세스 형식: 읽기 전용
한정자: MappingStrings ("MIF. DMTF| 작동 상태|003.3")

논리 디바이스의 상태입니다. 이 속성이 논리 디바이스에 적용되지 않는 경우 값 5(해당 없음)를 사용해야 합니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

기타 (1)

알 수 없음 (2)

사용 (3)

사용 안 함 (4)

해당 없음 (5)

SubclassCode

데이터 형식: uint8
액세스 형식: 읽기 전용

USB 서브클래스 코드.

SystemCreationClassName

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: 전파( "CIM_System. CreationClassName"), CIM_Key

범위 지정 시스템의 생성 클래스 이름입니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

SystemName

데이터 형식: 문자열
액세스 형식: 읽기 전용
한정자: 전파됨 ("CIM_System. 이름"), CIM_Key

범위 지정 시스템 이름입니다.

이 속성은 CIM_LogicalDevice 상속됩니다.

USBVersion

데이터 형식: uint16
액세스 형식: 읽기 전용

USB 디바이스에서 지원하는 최신 USB 버전입니다. 이 속성은 BCD(이진 코드 10진수)로 표현됩니다. 여기서 소수점은 두 번째와 세 번째 숫자 사이에 암시됩니다. 예를 들어 0x201 값은 버전 2.01이 지원됨을 나타냅니다.

설명

CIM_USBDevice 클래스는 CIM_LogicalDevice 파생됩니다.

WMI는 이 클래스를 구현하지 않습니다. CIM_USBDevice 구현하는 WMI 클래스는 Win32 클래스를 참조하세요.

이 설명서는 DMTF에서 게시한 CIM 클래스 설명을 바탕으로 합니다. Microsoft에서 사소한 오류를 수정하거나, Microsoft SDK 설명서 표준을 준수하거나, 자세한 정보를 제공하기 위해 내용을 변경했을 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
네임스페이스	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

추가 정보

CIM_LogicalDevice

CIM_USBDevice 클래스(CIMWin32 WMI 공급자)

구문

멤버

메서드

속성

설명

요구 사항

추가 정보

피드백

피드백

추가 리소스