NdisMSetMiniportAttributes 関数 (ndis.h)

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

ミニポートドライバーは、NDIS にミニポートアダプターのコンテキスト領域を識別し、NDIS ミニポートアダプターに関する情報を提供するには、そのミニポートInitializeEx 関数から NdisMSetMiniportAttributes 関数を呼び出す必要があります。

構文

NDIS_STATUS NdisMSetMiniportAttributes(
       NDIS_HANDLE                       NdisMiniportHandle,
  [in] PNDIS_MINIPORT_ADAPTER_ATTRIBUTES MiniportAttributes
);

パラメーター

NdisMiniportHandle

NDIS が MiniportInitializeEx の MiniportAdapterHandle パラメーターに渡したミニポートアダプターハンドル。

[in] MiniportAttributes

へのポインター NDIS_MINIPORT_ADAPTER_ATTRIBUTES ドライバー割り当て属性構造体を含む共用体です。構造体は、 MiniportAdapterHandle が指定するミニポートアダプターインスタンスの属性を定義します。

戻り値

NdisMSetMiniportAttributes は、 次のいずれかの状態値を返します。

リターンコード	説明
NDIS_STATUS_SUCCESS	NdisMSetMiniportAttributes によってミニポートアダプター属性が正常に登録されました。
NDIS_STATUS_BAD_VERSION	NDIS が、MiniportAttributes のヘッダーメンバーで指定された構造体の Revision メンバーで指定されているバージョンをサポートしていないことを示します。

注釈

ミニポートドライバーは、ドライバーが NdisMSetMiniportAttributes に提供される情報に依存する他の NdisXxx 関数を呼び出す前に、その MiniportInitializeEx 関数から NdisMSetMiniportAttributes を呼び出す必要があります。

次に、共用体NDIS_MINIPORT_ADAPTER_ATTRIBUTES は、さまざまな属性構造のプレースホルダーです。ミニポートドライバーは、異なる属性構造を持つ NdisMSetMiniportAttributes を複数回呼び出します。ミニポートドライバーは、初期化されたを提供する必要がありますMiniportInitializeEx から構造体をNDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTESします。ミニポートドライバーは、これらの属性またはハードウェアリソースを要求する他の NdisXxx 関数を呼び出す前に、これらの登録属性を提供する必要があります。

ドライバーは、NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES構造体の NDIS にミニポートAdapterContext メンバーを提供します。 MiniportAdapterContext メンバーは、NDIS がドライバーの MiniportXxx 関数に入力パラメーターとして渡す呼び出し元が指定したコンテキスト領域を識別します。このコンテキスト領域には、ミニポートアダプター固有の状態情報が含まれています。

ミニポートドライバーは、の属性を設定する必要があります。 NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES 構造体は、 NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES 構造体で登録属性を設定した後、追加の属性を設定する前に行います。

ミニポートドライバーは、そのミニポートAddDevice 関数から NdisMSetMiniportAttributes を呼び出すこともできます。この場合、 NDIS_MINIPORT_ADD_DEVICE_REGISTRATION_ATTRIBUTES 構造体を使用してコンテキスト領域を指定します。

要件

要件	値
サポートされている最小のクライアント	NDIS 6.0 以降でサポートされています。
対象プラットフォーム	ユニバーサル
Header	ndis.h (Ndis.h を含む)
Library	Ndis.lib
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則	Irql_Miniport_Driver_Function(ndis)、 NdisMRegisterIoPortRange(ndis)