struktur NDIS_RESTART_ATTRIBUTES (ndis.h)

Artikel
02/29/2024

Struktur NDIS_RESTART_ATTRIBUTES mengidentifikasi entri atribut dalam daftar atribut hidupkan ulang yang ditautkan.

Sintaks

typedef struct _NDIS_RESTART_ATTRIBUTES {
  PNDIS_RESTART_ATTRIBUTES Next;
  NDIS_OID                 Oid;
  ULONG                    DataLength;
  UCHAR                    Data[1];
} NDIS_RESTART_ATTRIBUTES, *PNDIS_RESTART_ATTRIBUTES;

Anggota

Next

Penunjuk ke struktur NDIS_RESTART_ATTRIBUTES yang dapat Anda gunakan untuk mengakses set atribut hidupkan ulang berikutnya dalam daftar atribut yang ditautkan. Jika tidak ada atribut tambahan, anggota ini adalah NULL.

Oid

Pengidentifikasi objek NDIS untuk informasi yang ada di anggota Data . Misalnya, jika Oid adalah OID_GEN_MINIPORT_RESTART_ATTRIBUTES, anggota Data berisi NDIS_RESTART_GENERAL_ATTRIBUTES struktur.

DataLength

Panjang, dalam byte, dari informasi yang disimpan di anggota Data .

Data[1]

Buffer yang berisi informasi yang terkait dengan OID yang ditentukan dalam anggota Oid .

Keterangan

Ketika NDIS memulai ulang tumpukan driver, NDIS meneruskan penunjuk ke daftar atribut hidupkan ulang yang ditautkan ke driver miniport, filter, dan protokol.

Ketika memanggil fungsi MiniportRestart driver miniport, NDIS meneruskan pointer ke struktur NDIS_RESTART_ATTRIBUTES ke driver miniport di anggota RestartAttributes NDIS_MINIPORT_RESTART_PARAMETERS struktur.

Ketika memanggil fungsi FilterRestart driver filter, NDIS meneruskan penunjuk ke struktur NDIS_RESTART_ATTRIBUTES ke driver filter di anggota RestartAttributes dari NDIS_FILTER_RESTART_PARAMETERS struktur.

Saat memulai ulang pengikatan protokol, NDIS menyediakan penunjuk ke struktur NDIS_RESTART_ATTRIBUTES di anggota RestartAttributes dari NDIS_PROTOCOL_RESTART_PARAMETERS struktur. Untuk memulai ulang pengikatan protokol, NDIS memanggil fungsi ProtocolNetPnPEvent driver protokol. Anggota NetPnPEvent dari NET_PNP_EVENT_NOTIFICATION struktur, yang diteruskan NDIS ke ProtocolNetPnPEvent, berisi struktur NET_PNP_EVENT . Struktur NET_PNP_EVENT menentukan NetEventRestart di anggota NetEvent dan pointer ke struktur NDIS_PROTOCOL_RESTART_PARAMETERS di anggota Buffer .

Jika penunjuk atribut restart yang diteruskan NDIS ke driver NDIS adalah NULL, driver tidak boleh menyebarluaskan atribut mereka mengubah tumpukan driver. Dalam situasi ini, driver tidak boleh memodifikasi, atau melaporkan perubahan atribut apa pun.

Jika penunjuk atribut hidupkan ulang bukan NULL, daftar struktur NDIS_RESTART_ATTRIBUTES yang ditautkan memiliki setidaknya satu entri yang berisi NDIS_RESTART_GENERAL_ATTRIBUTES struktur. Entri lainnya, jika ada, berisi atribut khusus media.