NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES構造体 (ndis.h)

[アーティクル]
08/07/2023

NDIS ミニポートドライバーは、ミニポートアダプターに関連付けられている登録属性を定義する NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES 構造体を設定します。

構文

typedef struct _NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES {
  NDIS_OBJECT_HEADER  Header;
  NDIS_HANDLE         MiniportAdapterContext;
  ULONG               AttributeFlags;
  UINT                CheckForHangTimeInSeconds;
  NDIS_INTERFACE_TYPE InterfaceType;
} NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES, *PNDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES;

メンバー

Header

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

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

NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES_REVISION_2

NDIS 6.30 の AttributeFlags フラグを追加しました。

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

NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES_REVISION_1

NDIS 6.0 の元のバージョン。

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

MiniportAdapterContext

ミニポートドライバーがその MiniportInitializeEx 関数で割り当てたコンテキスト領域へのハンドル。ミニポートドライバーは、このコンテキスト領域を使用して、ミニポートアダプターの状態情報を維持します。

AttributeFlags

ビットごとの OR と組み合わされたフラグのビットマスク。 NDIS ミニポートドライバーは、次のフラグの 1 つ以上を設定する必要があります。

NDIS_MINIPORT_ATTRIBUTES_HARDWARE_DEVICE

ミニポートドライバーが物理デバイスを直接制御する場合に設定します。物理デバイスには、割り込み、I/O ポート、メモリマップされた I/O、ミニポートドライバーから要求する DMA チャネルなどのハードウェアリソースが割り当てられます MiniportInitializeEx 関数。

NDIS_MINIPORT_ATTRIBUTES_NDIS_WDM

ミニポートアダプターの下位レベルのインターフェイスが USB や IEEE 1394 などの WDM バスドライバーである場合に設定します。この場合、ミニポートドライバーは、I/O ポート、割り込み、メモリマップ I/O、DMA チャネルなどのハードウェアリソースを割り当てません。代わりに、ドライバーは、基になるバスドライバーの WDM インターフェイスを介してデバイスと通信します。

NDIS_MINIPORT_ATTRIBUTES_BUS_MASTER

呼び出し元の NIC がバスマスター DMA デバイスである場合に設定します。

NDIS_MINIPORT_ATTRIBUTES_NO_HALT_ON_SUSPEND

システムが低電力 (スリープ) 状態に移行する前に、NDIS がミニポートドライバーの MiniportHaltEx 関数を呼び出さない場合に設定します。ハードウェア保守状態に依存するドライバーでは、このフラグを設定しないでください。

NDIS_MINIPORT_ATTRIBUTES_SURPRISE_REMOVE_OK

ミニポートドライバーがユーザー通知なしで NIC の削除を処理できるかどうかを設定します。 NDIS ドライバーは、で突然の削除通知を受け取る MiniportDevicePnPEventNotify 関数。

NDIS_MINIPORT_ATTRIBUTES_NOT_CO_NDIS

デバイスがコネクションレスデバイスであることを示すために、接続指向デバイスとコネクションレスデバイスの両方をサポートできるミニポートドライバーによって設定されます。

NDIS_MINIPORT_ATTRIBUTES_DO_NOT_BIND_TO_ALL_CO

TAPI サービスを提供しない CoNDIS ミニポートドライバーによって設定されます。 NDIS_MINIPORT_ATTRIBUTES_DO_NOT_BIND_TO_ALL_CO設定すると、NDIS がミニポートドライバーを NDIS TAPI プロキシドライバー (NDPROXY) にバインドできなくなります。既定では、NDIS は、すべての CoNDIS ミニポートドライバーに NDPROXY をバインドします。

NDIS_MINIPORT_ATTRIBUTES_CONTROLS_DEFAULT_PORT

NdisMNetPnPEvent 関数を呼び出して既定のポートをアクティブにするミニポートドライバーによって設定されます。 NDIS_MINIPORT_ATTRIBUTES_CONTROLS_DEFAULT_PORTが設定されていない場合、既定のポートはアクティブです。 NDIS では、既定のポートがアクティブでない場合、プロトコルドライバーをバインドしたり、フィルターモジュールをミニポートアダプターにアタッチしたりしません。

NDIS_MINIPORT_ATTRIBUTES_NO_PAUSE_ON_SUSPEND

NDIS 6.30 以降では、ミニポートドライバーが一時停止せずに低電力状態に移行できる場合、このフラグが設定されます。

このフラグの詳細については、「解説」セクションを参照してください。

NDIS_MINIPORT_ATTRIBUTES_REGISTER_BUGCHECK_CALLBACK

NDIS 6.30 ミニポート以降、このフラグが設定されていない限り、NDIS は BugCheck 中にミニポートのミニポートのミニポートShutdownEx ハンドラーを呼び出しません。ほとんどのミニポートでは、このフラグを設定しないでください。

CheckForHangTimeInSeconds

NDIS がを呼び出すタイムアウト間隔 (秒単位) MiniportCheckForHangEx 関数。ミニポートドライバーが OID 要求または 2 回連続して MiniportCheckForHangEx を呼び出す送信要求に応答していない場合、NDIS はミニポートドライバーのミニポートResetEx 関数を呼び出すことができます。

MiniportCheckForHangEx を呼び出すときに NDIS が使用する間隔は、常に 2 秒の倍数です。たとえば、5 秒を指定すると、間隔は約 4 秒になります。

このメンバーが 0 の場合、既定のタイムアウト間隔は 2 秒です。

メモタイムアウト間隔は、ミニポートドライバーの初期化時間よりも長くする必要があります。詳細については、「ミニポートアダプターのハングチェックとリセット操作」を参照してください。

InterfaceType

ミニポートアダプターの I/O バスインターフェイスの種類。これは通常、ミニポートアダプターが接続されている I/O バスの種類です。 NDIS 6.0 では、次の値がサポートされています。

NdisInterfaceInternal

ホスト固有の内部インターフェイスを指定します。

NdisInterfaceIsa

ISA インターフェイスを指定します。

NdisInterfaceEisa

拡張 ISA (EISA) インターフェイスを指定します。このインターフェイスの種類は、NDIS 6.0 以降のバージョンではサポートされていません。

NdisInterfaceMca

サポートされなくなった MCA バスを参照します。このインターフェイスの種類は、NDIS 6.0 以降のバージョンではサポートされていません。

NdisInterfaceTurboChannel

Turbo チャネルインターフェイスを指定します。

NdisInterfacePci

周辺機器コンポーネント相互接続 (PCI) インターフェイスを指定します。

NdisInterfacePcMcia

パーソナルコンピューターメモリカード国際協会 (PC カード) インターフェイスを指定します。

NdisInterfaceCBus

CBus を指定します。

NdisInterfaceMPIBus

MPIBus を指定します。

NdisInterfaceMPSABus

MPSABus を指定します。

NdisInterfaceProcessorInternal

プロセッサ内部バスを指定します。

NdisInterfaceInternalPowerBus

内部電源バスを指定します。

NdisInterfacePNPISABus

PNPISABus を指定します。

NdisInterfacePNPBus

PNPBus を指定します。

このパラメーターは中間ドライバーには関係ありません。このメンバーには 0 を指定する必要があります。

注釈

ミニポートドライバーは、の MiniportAttributes パラメーター内のNDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES構造体へのポインターを渡します。 NdisMSetMiniportAttributes 関数。ミニポートドライバーは、初期化中にミニポートInitializeEx 関数から NdisMSetMiniportAttributes を呼び出します。

ミニポートドライバーは、 ミニポートInitializeEx 内でできるだけ早くNDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTESで属性を設定する必要があります。これらの属性の設定は必須です。

NDIS_MINIPORT_ATTRIBUTES_NO_PAUSE_ON_SUSPEND フラグ

NDIS は、基になるミニポートアダプターが D1、D2、または D3 の低電力状態に移行する前に、ミニポートドライバーにOID_PNP_SET_POWERの OID 要求を発行します。ドライバーは、この OID を処理するときに、下位の電源状態への移行のミニポートアダプターを準備する必要があり、保留中の受信パケットの表示の完了を待つ必要はありません。

場合によっては、NDIS がミニポートドライバーに OID_PNP_SET_POWER の OID 要求を発行する前に、NDIS はミニポートドライバーの MiniportPause 関数を呼び出します。次に説明します。

NDIS_MINIPORT_ATTRIBUTES_NO_PAUSE_ON_SUSPEND フラグが設定されていない場合、NDIS は、ドライバーに対してOID_PNP_SET_POWERの OID 要求が発行される前に、ミニポートドライバーの MiniportPause 関数を呼び出します。 MiniportPause 呼び出しのコンテキスト内で、ドライバーは保留中の受信パケット表示の完了を待機する必要があります。
NDIS_MINIPORT_ATTRIBUTES_NO_PAUSE_ON_SUSPEND フラグが設定されている場合、NDIS は、ドライバーに対してOID_PNP_SET_POWERの OID 要求が発行される前に、ミニポートドライバーの MiniportPause 関数を呼び出しません。ミニポートドライバーは、OID 要求を処理するときに、低電力状態への移行のミニポートアダプターを準備するときに、以前に一時停止されていたと想定する必要があります。
メモこれに対する例外は、NDIS 6.20 以前のバージョンの NDIS をサポートするプロトコルまたはフィルタードライバーがミニポートアダプターにバインドまたはアタッチされている場合に発生します。この場合、NDIS は、ミニポートドライバーがNDIS_MINIPORT_ATTRIBUTES_NO_PAUSE_ON_SUSPEND フラグを設定するかどうかに関係なく、ミニポートドライバーのミニポートPause 関数を呼び出します。