NDIS_MINIPORT_SS_CHARACTERISTICS構造体 (ndis.h)

[アーティクル]
02/26/2024

NDIS_MINIPORT_SS_CHARACTERISTICS構造体は、ミニポートドライバーの NDIS 選択的中断ハンドラー関数へのポインターを指定します。これらの関数は、選択的な中断操作中にドライバーにアイドル状態の通知を発行するために NDIS によって呼び出されます。

構文

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;

メンバー

Header

NDIS_MINIPORT_SS_CHARACTERISTICS構造体の型、リビジョン、およびサイズ。このメンバーは、 NDIS_OBJECT_HEADER 構造体として書式設定されます。

ミニポートドライバーは、ヘッダーの Type メンバーをNDIS_OBJECT_TYPE_MINIPORT_SS_CHARACTERISTICSに設定する必要があります。 NDIS_MINIPORT_SS_CHARACTERISTICS構造体のバージョンを指定するには、ドライバーで Header の Revision メンバーを次の値に設定する必要があります。

NDIS_MINIPORT_SS_CHARACTERISTICS_REVISION_1

NDIS 6.30 以降の元のバージョン。

[サイズ] メンバーを [NDIS_SIZEOF_MINIPORT_SS_CHARACTERISTICS_REVISION_1] に設定します。

Flags

フラグのビットごとの OR を含む ULONG 値。このメンバーは NDIS 用に予約されています。

IdleNotificationHandler

ミニポートドライバーの MiniportIdleNotification 関数へのポインター。

CancelIdleNotificationHandler

ミニポートドライバーの MiniportCancelIdleNotification 関数へのポインター。

注釈

NDIS 選択的中断のハンドラー関数を登録するには、ミニポートドライバーは、ミニポートセットオプション関数が呼び出されたときに、次の手順に従います。

ミニポートドライバーは、ハンドラー関数へのポインターを使用して NDIS_MINIPORT_SS_CHARACTERISTICS 構造体を初期化します。
その後、ミニポートドライバーは NdisSetOptionalHandlers を呼び出し、 OptionalHandlers パラメーターを NDIS_MINIPORT_SS_CHARACTERISTICS 構造体へのポインターに設定します。

NDIS 選択的中断のアイドル通知を処理する方法の詳細については、「 NDIS 選択的中断アイドル通知」を参照してください。