struktur NDIS_MINIPORT_SS_CHARACTERISTICS (ndis.h)

Artikel
02/29/2024

Struktur NDIS_MINIPORT_SS_CHARACTERISTICS menentukan penunjuk ke fungsi penangan tangguhan selektif NDIS driver miniport. Fungsi-fungsi ini dipanggil oleh NDIS untuk mengeluarkan pemberitahuan menganggur ke driver selama operasi penangguhan selektif.

Sintaks

typedef struct _NDIS_MINIPORT_SS_CHARACTERISTICS {
  NDIS_OBJECT_HEADER                        Header;
  ULONG                                     Flags;
  MINIPORT_IDLE_NOTIFICATION_HANDLER        IdleNotificationHandler;
  MINIPORT_CANCEL_IDLE_NOTIFICATION_HANDLER CancelIdleNotificationHandler;
} NDIS_MINIPORT_SS_CHARACTERISTICS, *PNDIS_MINIPORT_SS_CHARACTERISTICS;

Anggota

Header

Jenis, revisi, dan ukuran struktur NDIS_MINIPORT_SS_CHARACTERISTICS . Anggota ini diformat sebagai struktur NDIS_OBJECT_HEADER .

Driver miniport harus mengatur anggota JenisHeader ke NDIS_OBJECT_TYPE_MINIPORT_SS_CHARACTERISTICS. Untuk menentukan versi struktur NDIS_MINIPORT_SS_CHARACTERISTICS , driver harus mengatur anggota RevisiHeader ke nilai berikut:

NDIS_MINIPORT_SS_CHARACTERISTICS_REVISION_1

Versi asli untuk NDIS 6.30 dan yang lebih baru.

Atur anggota Ukuran ke NDIS_SIZEOF_MINIPORT_SS_CHARACTERISTICS_REVISION_1.

Flags

Nilai ULONG yang berisi bitwise ATAU bendera. Anggota ini dicadangkan untuk NDIS.

IdleNotificationHandler

Penunjuk ke fungsi MiniportIdleNotification driver miniport .

CancelIdleNotificationHandler

Penunjuk ke fungsi MiniportCancelIdleNotification driver miniport .

Keterangan

Untuk mendaftarkan fungsi handler untuk penangguhan selektif NDIS, driver miniport mengikuti langkah-langkah ini ketika fungsi MiniportSetOptions-nya disebut:

Driver miniport menginisialisasi struktur NDIS_MINIPORT_SS_CHARACTERISTICS dengan pointer ke fungsi handler.
Driver miniport kemudian memanggil NdisSetOptionalHandlers dan mengatur parameter OptionalHandlers ke penunjuk ke struktur NDIS_MINIPORT_SS_CHARACTERISTICS .

Untuk informasi selengkapnya tentang cara menangani pemberitahuan diam untuk penangguhan selektif NDIS, lihat Pemberitahuan Diam Tangguhkan Selektif NDIS.