struktur NDIS_PROTOCOL_RESTART_PARAMETERS (ndis.h)

  • Artikel

Struktur NDIS_PROTOCOL_RESTART_PARAMETERS menentukan parameter hidupkan ulang untuk driver protokol ketika NDIS memanggil fungsi ProtocolNetPnPEvent untuk menunjukkan peristiwa NetEventRestart .

Sintaks

typedef struct _NDIS_PROTOCOL_RESTART_PARAMETERS {
  NDIS_OBJECT_HEADER       Header;
  PUCHAR                   FilterModuleNameBuffer;
  ULONG                    FilterModuleNameBufferLength;
  PNDIS_RESTART_ATTRIBUTES RestartAttributes;
  NET_IFINDEX              BoundIfIndex;
  NET_LUID                 BoundIfNetluid;
  ULONG                    Flags;
} NDIS_PROTOCOL_RESTART_PARAMETERS, *PNDIS_PROTOCOL_RESTART_PARAMETERS;

Anggota

Header

Struktur NDIS_OBJECT_HEADER untuk struktur NDIS_PROTOCOL_RESTART_PARAMETERS. NDIS mengatur anggota Jenis struktur yang ditentukan Header untuk NDIS_OBJECT_TYPE_PROTOCOL_RESTART_PARAMETERS, anggota Revisi ke NDIS_PROTOCOL_RESTART_PARAMETERS_REVISION_1, dan anggota Ukuran ke NDIS_SIZEOF_PROTOCOL_RESTART_PARAMETERS_REVISION_1.

FilterModuleNameBuffer

Daftar nama modul filter yang mendasar. Untuk setiap nama, buffer berisi nilai USHORT yang diikuti oleh string karakter lebar. Gunakan nilai USHORT pertama dalam buffer untuk menentukan panjang string pertama. Gunakan panjang string pertama untuk menentukan awal string berikutnya. Lanjutkan dengan cara ini hingga jumlah byte yang diambil dari buffer sama dengan jumlah byte yang ditentukan dalam anggota FilterModuleNameBufferLength .

FilterModuleNameBufferLength

Panjangnya, dalam byte, dari buffer di anggota FilterModuleNameBuffer .

RestartAttributes

Penunjuk ke entri pertama dalam daftar struktur NDIS_RESTART_ATTRIBUTES . Gunakan anggota berikutnya dari struktur NDIS_RESTART_ATTRIBUTES untuk mendapatkan struktur berikutnya dalam daftar.

BoundIfIndex

Indeks antarmuka jaringan NDIS dari antarmuka tingkat tertinggi yang ditumpuk pada adaptor miniport. Artinya, jika ada miniport virtual atau modul filter yang dipasang melalui adaptor miniport, anggota ini adalah IfIndex dari miniport virtual tingkat tertinggi atau modul filter.

BoundIfNetluid

Nilai NET_LUID NDIS (yang juga merupakan nama antarmuka jaringan (ifName di RFC 2863)) dari antarmuka tingkat tertinggi yang ditumpuk pada adaptor miniport. Artinya, jika ada miniport virtual atau modul filter yang diinstal melalui adaptor miniport, anggota ini adalah nilai NET_LUID dari miniport virtual tingkat tertinggi atau modul filter.

Flags

Disiapkan untuk penggunaan masa mendatang.

Keterangan

NDIS meneruskan struktur NDIS_PROTOCOL_RESTART_PARAMETERS ke driver protokol ketika memanggil fungsi ProtocolNetPnPNPEvent untuk menunjukkan peristiwa NetEventRestart .

Setiap nama yang ditentukan dalam buffer di anggota FilterModuleNameBuffer tidak dijamin dihentikan NULL. Nilai USHORT di awal setiap string berisi panjang, dalam byte, dari string. Driver protokol harus memeriksa nilai anggota FilterModuleNameBufferLength sebelum mereka mengakses buffer.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Didukung di NDIS 6.0 dan yang lebih baru.
Header ndis.h (termasuk Ndis.h)

Lihat juga

NDIS_OBJECT_HEADER

NDIS_RESTART_ATTRIBUTES

ProtocolNetPnPEvent