EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS fungsi panggilan balik (ucxcontroller.h)

  • Artikel

UCX memanggil panggilan balik ini untuk mengambil karakteristik pengontrol host.

Sintaks

EVT_UCX_CONTROLLER_GET_TRANSPORT_CHARACTERISTICS EvtUcxControllerGetTransportCharacteristics;

NTSTATUS EvtUcxControllerGetTransportCharacteristics(
  [in]  UCXCONTROLLER UcxController,
  [out] PUCX_CONTROLLER_TRANSPORT_CHARACTERISTICS UcxControllerTransportCharacteristics
)
{...}

Parameter

[in] UcxController

Handel ke pengontrol UCX yang diterima driver klien dalam panggilan sebelumnya ke metode UcxControllerCreate .

[out] UcxControllerTransportCharacteristics

Pointer ke struktur UCX_CONTROLLER_TRANSPORT_CHARACTERISTICS yang diisi driver klien untuk pengontrol host dengan karakteristik transportasi.

Nilai kembali

Jika operasi berhasil, fungsi panggilan balik harus mengembalikan STATUS_SUCCESS, atau nilai status lain yang NT_SUCCESS(status) sama dengan TRUE. Jika tidak, nilai status harus dikembalikan yang NT_SUCCESS(statusnya) sama dengan FALSE.

Keterangan

Driver klien UCX mendaftarkan implementasinya dengan ekstensi pengontrol host USB (UCX) dengan memanggil metode UcxControllerCreate .

Fungsi panggilan balik ini bersifat opsional. Setiap kali karakteristik transportasi berubah, driver klien bertanggung jawab untuk memberi tahu UCX bahwa salah satu karakteristik telah berubah menggunakan fungsi baru UcxControllerNotifyTransportCharacteristicsChange.

Persyaratan

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

Lihat juga

UcxControllerBuat