CIM_USBDevice 클래스의 GetDescriptor 메서드(Wmcodecdsp.h)
GetDescriptor 메서드는 입력 매개 변수에 지정된 대로 USB 디바이스 설명자를 반환합니다.
중요
DMTF(분산 관리 태스크 포스) CIM(일반 정보 모델) 클래스는 WMI 클래스를 빌드하는 부모 클래스입니다. WMI는 현재 CIM 2.x 버전 스키마만 지원합니다.
이 항목에서는 MOF(Managed Object Format) 구문을 사용합니다. 이 메서드를 사용하는 방법에 대한 자세한 내용은 메서드 호출을 참조하세요.
구문
uint32 GetDescriptor(
[in] uint8 RequestType,
[in] uint16 RequestValue,
[in] uint16 RequestIndex,
[in, out] uint16 RequestLength,
[out] uint8 Buffer[]
);
매개 변수
-
RequestType [in]
-
설명자 요청 유형 및 받는 사람에 대한 비트 매핑 식별자입니다. 각 비트에 대한 적절한 값은 USB 사양을 참조하세요.
-
RequestValue [in]
-
상위 바이트의 설명자 형식과 설명자 인덱스(예: 설명자 배열에 대한 인덱스 또는 오프셋)를 낮은 바이트 단위로 포함합니다. 자세한 내용은 USB 사양을 참조하세요.
-
RequestIndex [in]
-
문자열 설명자 데이터를 반환할 때 USB 디바이스에서 사용하는 2 바이트 언어 식별자 코드를 지정합니다. 매개 변수는 일반적으로 문자열이 아닌 설명자의 경우 0입니다. 자세한 내용은 USB 사양을 참조하세요.
-
RequestLength [in, out]
-
입력에서 반환해야 하는 설명자의 길이(8진수)입니다. 이 값이 설명자의 실제 길이보다 작으면 요청된 길이만 반환됩니다. 실제 길이보다 큰 경우 실제 길이가 반환됩니다.
출력에서 반환되는 버퍼의 길이(8진수)입니다. 요청된 설명자가 없으면 이 매개 변수의 내용이 정의되지 않습니다.
-
버퍼 [out]
-
요청된 설명자 정보를 반환합니다. 설명자가 없으면 이 매개 변수의 내용이 정의되지 않습니다.
반환 값
USB 설명자가 성공적으로 반환되면 0 값, 요청이 지원되지 않는 경우 1(1) 및 오류를 나타내는 다른 숫자를 반환합니다. 서브클래스의 경우 메서드에서 ValueMap 한정자를 사용하여 가능한 반환 코드 집합을 지정할 수 있습니다. mofqualifier 콘텐츠가 번역되는 문자열은 서브클래스에 값 배열 한정자로 지정할 수도 있습니다.
설명
이 메서드는 현재 WMI에서 구현되지 않습니다. 이 메서드를 사용하려면 자체 공급자에서 구현해야 합니다.
이 설명서는 DMTF에서 게시한 CIM 클래스 설명을 바탕으로 합니다. Microsoft에서 사소한 오류를 수정하거나, Microsoft SDK 설명서 표준을 준수하거나, 자세한 정보를 제공하기 위해 내용을 변경했을 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows Vista |
| 지원되는 최소 서버 |
Windows Server 2008 |
| 네임스페이스 |
Root\CIMV2 |
| 헤더 |
|
| MOF |
|
| DLL |
|