Metode GetDescriptor dari kelas CIM_USBHub

Artikel
06/12/2023

Metode GetDescriptor mengembalikan deskriptor hub USB seperti yang ditentukan oleh parameter input.

Penting

Kelas CIM (Model Informasi Umum) DMTF (Distributed Management Task Force) adalah kelas induk tempat kelas WMI dibangun. WMI saat ini hanya mendukung skema versi CIM 2.x.

Topik ini menggunakan sintaks Managed Object Format (MOF). Untuk informasi selengkapnya tentang menggunakan metode ini, lihat Memanggil Metode.

Sintaks

uint32 GetDescriptor(
  [in]      uint8  RequestType,
  [in]      uint16 RequestValue,
  [in]      uint16 RequestIndex,
  [in, out] uint16 RequestLength,
  [out]     uint8  Buffer[]
);

Parameter

RequestType [in]

Pengidentifikasi yang dipetakan bit untuk jenis permintaan deskriptor dan penerima. Untuk nilai yang sesuai untuk setiap bit, lihat spesifikasi USB.

RequestValue [in]

Berisi jenis deskriptor dalam byte tinggi dan indeks deskriptor (misalnya, indeks atau offset ke dalam array deskriptor) dalam byte rendah. Untuk informasi selengkapnya, lihat spesifikasi USB.

RequestIndex [in]

Menentukan kode pengidentifikasi bahasa 2-byte yang digunakan oleh perangkat USB saat mengembalikan data deskriptor string. Parameter biasanya 0 (nol) untuk deskriptor nonstring. Untuk informasi selengkapnya, lihat spesifikasi USB.

RequestLength [masuk, keluar]

Pada input, panjang (dalam oktet) deskriptor yang harus dikembalikan. Jika nilai ini kurang dari panjang deskriptor aktual, hanya panjang yang diminta yang dikembalikan. Jika lebih dari panjang aktual, panjang aktual dikembalikan.

Pada output, panjang (dalam oktet) buffer yang dikembalikan. Jika deskriptor yang diminta tidak ada, konten parameter ini tidak terdefinisi.

Buffer [out]

Buffer mengembalikan informasi deskriptor yang diminta. Jika deskriptor tidak ada, konten buffer tidak terdefinisi.

Menampilkan nilai

Mengembalikan nilai 0 (nol) jika deskriptor USB berhasil dikembalikan, 1 (satu) jika permintaan tidak didukung, dan angka lain untuk menunjukkan kesalahan. Dalam subkelas, kumpulan kemungkinan kode pengembalian dapat ditentukan dengan menggunakan kualifikasi ValueMap pada metode . String tempat konten mofqualifier diterjemahkan juga dapat ditentukan dalam subkelas sebagai kualifikasi array Nilai .

Keterangan

Metode ini saat ini tidak diimplementasikan oleh WMI. Untuk menggunakan metode ini, Anda harus menerapkannya di penyedia Anda sendiri.

Dokumentasi ini berasal dari deskripsi kelas CIM yang diterbitkan oleh DMTF. Microsoft mungkin telah membuat perubahan untuk memperbaiki kesalahan kecil, sesuai dengan standar dokumentasi Microsoft SDK, atau memberikan informasi selengkapnya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Ruang nama	Root\CIMV2
Header	Wmcodecdsp.h
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Lihat juga

CIM_USBHub
CIM_USBHub

Bagikan melalui