Fungsi PcNewResourceList (portcls.h)

Artikel
02/26/2024

Fungsi PcNewResourceList membuat dan menginisialisasi daftar sumber daya.

Sintaks

PORTCLASSAPI NTSTATUS PcNewResourceList(
  [out]          PRESOURCELIST     *OutResourceList,
  [in, optional] PUNKNOWN          OuterUnknown,
  [in]           POOL_TYPE         PoolType,
  [in]           PCM_RESOURCE_LIST TranslatedResources,
  [in]           PCM_RESOURCE_LIST UntranslatedResources
);

Parameter

[out] OutResourceList

Penunjuk output untuk objek daftar sumber daya yang dibuat oleh fungsi ini. Parameter ini menunjuk ke variabel penunjuk yang dialokasikan penelepon tempat fungsi menghasilkan penunjuk ke objek IResourceList . Tentukan nilai pointer non-NULL yang valid untuk parameter ini.

[in, optional] OuterUnknown

Arahkan ke antarmuka IUnknown objek yang perlu mengagregasi objek daftar sumber daya. Kecuali agregasi diperlukan, atur parameter ini ke NULL.

[in] PoolType

Menentukan jenis kumpulan tempat objek akan dialokasikan. Ini adalah nilai enumerasi POOL_TYPE .

[in] TranslatedResources

Penunjuk ke daftar sumber daya yang disediakan WDM untuk sumber daya yang diterjemahkan. Daftar ini adalah struktur sistem jenis CM_RESOURCE_LIST.

[in] UntranslatedResources

Penunjuk ke daftar sumber daya yang disediakan WDM untuk sumber daya yang tidak diterjemahkan. Daftar ini adalah struktur sistem jenis CM_RESOURCE_LIST.

Nilai kembali

PcNewResourceList mengembalikan STATUS_SUCCESS jika panggilan berhasil. Jika tidak, kode kesalahan akan menampilkan kode kesalahan yang sesuai.

Keterangan

Untuk diskusi tentang daftar sumber daya yang diterjemahkan dan tidak diterjemahkan (atau "mentah"), lihat Memetakan Alamat Bus-Relative ke Alamat Virtual.

Parameter OutResourceList dan OuterUnknown mengikuti konvensi penghitungan referensi untuk objek COM.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Driver sistem PortCls mengimplementasikan fungsi PcNewResourceList di Microsoft Windows 98/Me dan di sistem operasi Windows 2000 dan yang lebih baru.
Target Platform	Universal
Header	portcls.h (termasuk Portcls.h)
Pustaka	Portcls.lib
IRQL	PASSIVE_LEVEL

Lihat juga

CM_RESOURCE_LIST

IResourceList

POOL_TYPE

Bagikan melalui