CIM_USBDevice類別的 GetDescriptor 方法， (Wmcodecdsp.h)

GetDescriptor方法會傳回輸入參數所指定的 USB 裝置描述元。

重要

DMTF (分散式管理工作組) CIM (Common Information Model) 類別是 WMI 類別建置所在的父類別。 WMI 目前僅支援 CIM 2.x 版本架構。

本主題使用 Managed 物件格式 (MOF) 語法。 如需使用此方法的詳細資訊，請參閱 呼叫 方法。

語法

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]

在輸入上，應該傳回之描述元的八進位) 長度 (。 如果此值小於描述項的實際長度，則只會傳回要求的長度。 如果超過實際長度，則會傳回實際長度。

輸出時，傳回緩衝區的八進位) 長度 (。 如果要求的描述元不存在，則此參數的內容未定義。

緩衝區 [out]

傳回要求的描述項資訊。 如果描述項不存在，則此參數的內容未定義。

傳回值

如果成功傳回 USB 描述元，則傳回值為 0 () 零，如果不支援要求，則傳回 1 (一) ，以及指出錯誤的任何其他數位。 在子類別中，可以使用 方法上的 ValueMap 限定詞來指定一組可能的傳回碼。 轉譯 mofqualifier 內容的字串也可以在子類別中指定為 Values 陣列限定詞。

備註

WMI 目前未實作這個方法。 若要使用此方法，您必須在自己的提供者中實作它。

本檔衍生自 DMTF 所發佈的 CIM 類別描述。 Microsoft 可能已變更更正次要錯誤、符合 Microsoft SDK 檔標準，或提供詳細資訊。

規格需求

需求	值
最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
命名空間	Root\CIMV2
標頭	Wmcodecdsp.h
MOF	CIMWin32.mof
DLL	CIMWin32.dll

另請參閱

CIM_USBDevice

CIM_USBDevice