Fungsi NdisMSetMiniportAttributes (ndis.h)

Artikel
08/07/2023

Driver miniport harus memanggil fungsi NdisMSetMiniportAttributes dari fungsi MiniportInitializeEx untuk mengidentifikasi area konteks untuk adaptor miniport ke NDIS, dan untuk memberikan informasi tentang adaptor miniport kepada NDIS.

Sintaks

NDIS_STATUS NdisMSetMiniportAttributes(
       NDIS_HANDLE                       NdisMiniportHandle,
  [in] PNDIS_MINIPORT_ADAPTER_ATTRIBUTES MiniportAttributes
);

Parameter

NdisMiniportHandle

Handel adaptor miniport yang diteruskan NDIS ke parameter MiniportAdapterHandle dari MiniportInitializeEx.

[in] MiniportAttributes

Penunjuk ke NDIS_MINIPORT_ADAPTER_ATTRIBUTES union yang berisi struktur atribut yang dialokasikan driver. Struktur mendefinisikan atribut instans adaptor miniport yang ditentukan MiniportAdapterHandle .

Nilai kembali

NdisMSetMiniportAttributes mengembalikan salah satu nilai status berikut:

Menampilkan kode	Deskripsi
NDIS_STATUS_SUCCESS	NdisMSetMiniportAttributes berhasil mendaftarkan atribut adaptor miniport.
NDIS_STATUS_BAD_VERSION	Menunjukkan bahwa NDIS tidak mendukung versi yang ditentukan dalam anggota Revisi struktur yang ditentukan dalam anggota Header di MiniportAttributes .

Keterangan

Driver miniport harus memanggil NdisMSetMiniportAttributes dari fungsi MiniportInitializeEx sebelum driver memanggil fungsi NdisXxx lainnya yang bergantung pada informasi yang disediakan untuk NdisMSetMiniportAttributes.

The NDIS_MINIPORT_ADAPTER_ATTRIBUTES union adalah tempat penampung untuk berbagai struktur atribut. Driver miniport memanggil NdisMSetMiniportAttributes beberapa kali dengan struktur atribut yang berbeda. Driver miniport harus menyediakan yang diinisialisasi NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES struktur dari MiniportInitializeEx. Driver miniport harus menyediakan atribut pendaftaran ini sebelum memanggil fungsi NdisXxx lainnya yang bergantung pada atribut ini atau yang mengklaim sumber daya perangkat keras.

Driver menyediakan anggota MiniportAdapterContext ke NDIS dalam struktur NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES . Anggota MiniportAdapterContext mengidentifikasi area konteks yang disediakan pemanggil yang diteruskan NDIS sebagai parameter input ke fungsi MiniportXxx driver. Area konteks ini berisi informasi status khusus adaptor miniport.

Driver miniport harus mengatur atribut di NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES struktur setelah mereka mengatur atribut pendaftaran dalam struktur NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES dan sebelum mereka mengatur atribut tambahan.

Driver miniport juga dapat memanggil NdisMSetMiniportAttributes dari fungsi MiniportAddDevice-nya . Dalam hal ini, struktur NDIS_MINIPORT_ADD_DEVICE_REGISTRATION_ATTRIBUTES digunakan untuk menentukan area konteks.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung di NDIS 6.0 dan yang lebih baru.
Target Platform	Universal
Header	ndis.h (termasuk Ndis.h)
Pustaka	Ndis.lib
IRQL	PASSIVE_LEVEL
Aturan kepatuhan DDI	Irql_Miniport_Driver_Function(ndis), NdisMRegisterIoPortRange(ndis)