Fungsi UcxUsbDeviceCreate (ucxusbdevice.h)

  • Artikel

Membuat objek perangkat USB pada pengontrol yang ditentukan.

Sintaks

NTSTATUS UcxUsbDeviceCreate(
  [in]           UCXCONTROLLER          Controller,
  [out]          PUCXUSBDEVICE_INIT     *UsbDeviceInit,
  [in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
  [out]          UCXUSBDEVICE           *UsbDevice
);

Parameter

[in] Controller

Handel ke objek pengontrol. Driver klien mengambil handel dalam panggilan sebelumnya ke UcxControllerCreate.

[out] UsbDeviceInit

Penunjuk ke struktur UCXUSBDEVICE_INIT yang menjelaskan berbagai operasi konfigurasi untuk membuat objek perangkat USB. Driver menentukan penunjuk fungsi ke fungsi panggilan baliknya dalam struktur ini. Struktur ini dikelola oleh UCX.

[in, optional] Attributes

Penunjuk ke struktur WDF_OBJECT_ATTRIBUTES yang dialokasikan pemanggil yang menentukan atribut untuk objek perangkat USB.

[out] UsbDevice

Pointer ke variabel yang menerima handel ke objek perangkat USB baru.

Nilai kembali

Metode mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, metode ini mungkin mengembalikan satu kode kesalahan NTSTATUS yang sesuai.

Keterangan

Driver klien untuk pengontrol host harus memanggil metode ini setelah panggilan WdfDeviceCreate . Induk objek perangkat USB baru adalah perangkat hub induk yang ditentukan oleh UCX.

Untuk contoh kode, lihat EVT_UCX_CONTROLLER_USBDEVICE_ADD.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10
Target Platform Windows
Versi KMDF minimum 1,0
Versi UMDF minimum 2.0
Header ucxusbdevice.h (termasuk Ucxclass.h)
IRQL PASSIVE_LEVEL

Lihat juga

EVT_UCX_CONTROLLER_USBDEVICE_ADD