Fungsi UrsIoResourceListAppendDescriptor (ursdevice.h)
Menambahkan pendeskripsi sumber daya yang ditentukan ke objek daftar sumber daya I/O yang ditentukan yang mempertahankan deskriptor sumber daya untuk peran host atau fungsi.
Sintaks
NTSTATUS UrsIoResourceListAppendDescriptor(
[in] URSIORESLIST IoResourceList,
[in] PIO_RESOURCE_DESCRIPTOR Descriptor
);
Parameter
[in] IoResourceList
Objek daftar sumber daya I/O peran tempat pendeskripsi sumber daya ditambahkan. Objek ini dialokasikan oleh kerangka kerja dan diteruskan ke driver klien ketika kerangka kerja memanggil implementasi EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS driver.
[in] Descriptor
Penunjuk ke IO_RESOURCE_DESCRIPTOR yang berisi deskriptor sumber daya untuk peran tersebut.
Nilai kembali
Metode mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, metode ini mungkin mengembalikan kode kesalahan NTSTATUS yang sesuai.
Keterangan
Setelah driver klien memanggil UrsDeviceInitialize, kerangka kerja mengalokasikan memori untuk daftar persyaratan sumber daya. Ketika ekstensi kelas peran ganda USB memanggil implementasi EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS driver klien, ekstensi ini meneruskan handel WDFIORESREQLIST ke daftar persyaratan tersebut bersama dengan handel URSIORESLIST untuk host dan daftar sumber daya peran fungsi. Dalam implementasi, driver klien diharapkan untuk menghitung melalui daftar persyaratan dan menambahkan pendeskripsi sumber daya (jika ingin menggunakan sumber daya tersebut) ke daftar sumber daya untuk setiap peran.
Untuk menambahkan deskriptor sumber daya untuk peran, driver memanggil UrsIoResourceListAppendDescriptor dan menentukan deskriptor dan daftar sumber daya tempat sumber daya harus ditambahkan.
Untuk contoh kode, lihat EVT_URS_DEVICE_FILTER_RESOURCE_REQUIREMENTS.
Untuk informasi selengkapnya tentang daftar persyaratan sumber daya, lihat Menangani Sumber Daya Perangkat Keras.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 10 |
Server minimum yang didukung | Server Windows 2016 |
Target Platform | Windows |
Versi KMDF minimum | 1.15 |
Header | ursdevice.h (termasuk Urscx.h) |
Pustaka | Urscxstub.lib |
IRQL | PASSIVE_LEVEL |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk