NdisOpenProtocolConfiguration 関数 (ndis.h)

  • [アーティクル]

メモ NDIS 5。 x は非推奨となり、NDIS 6 に置き換えられます。 x があります。 新しい NDIS ドライバーの開発については、「 Windows Vista 以降のネットワーク ドライバー」を参照してください。 NDIS 5 の移植について説明します。 x ドライバーを NDIS 6 に設定します。 x については、「 NDIS 5.x ドライバーを NDIS 6.0 に移植する」を参照してください。

NdisOpenProtocolConfiguration は、プロトコル ドライバーのアダプターごとの情報が格納されているレジストリ キーのハンドルを返します。

構文

void NdisOpenProtocolConfiguration(
  [out] PNDIS_STATUS  Status,
  [out] PNDIS_HANDLE  ConfigurationHandle,
  [in]  PCNDIS_STRING ProtocolSection
);

パラメーター

[out] Status

NDIS_STATUS_SUCCESSに設定されている呼び出し元が指定した変数へのポインター、またはこの関数からの戻り時のエラー状態。

[out] ConfigurationHandle

呼び出し元が後でバインドする名前付きミニポート ドライバーのレジストリ キーへのハンドルを返す呼び出し元が指定した変数へのポインター。 このキーの値エントリには、プロトコルがインストールされているアダプター固有の情報が含まれています。

[in] ProtocolSection

システムの既定の文字セットで指定された、カウントされた文字列を含む呼び出し元が指定したNDIS_STRING型へのポインター。 このカウントされた文字列は、NDIS NIC ドライバー (実質的にはアダプター) に名前を付けます。この名前は、レジストリ プロトコル セクションのアダプターごとのパラメーター キーを開く必要があります。 Windows 2000 以降のプロトコルの場合、このカウントされる文字列には Unicode 文字が含まれます。 つまり、Windows 2000 以降の場合、NDIS はNDIS_STRING型を UNICODE_STRING 型として定義します。

このポインターは、呼び出し元の ProtocolBindAdapter 関数への SystemSpecific1 入力パラメーターです。

戻り値

なし

解説

NdisOpenProtocolConfiguration は、呼び出し元が Ndis に後で渡すことができるハンドルを返します 。 レジストリに情報を取得または格納するための構成関数。

プロトコル ドライバーは 、NdisOpenProtocolConfiguration を呼び出して、その後他の Ndis に渡されるレジストリ キー ハンドルを取得 します。NdisRead/WriteConfiguration や NdisOpenConfigurationKeyByName/Index などの構成関数。インストール ファイルにアダプター固有の構成情報が格納されている場合は、プロトコルがバインドを設定するレジストリのプロトコル セクションに格納されます。

プロトコルでは、 NdisOpenConfigurationKeyByName または NdisOpenConfigurationKeyByIndex を呼び出して、 NdisOpenProtocolConfiguration がハンドルを返すレジストリ キーのサブキーを開くことができます。

Windows 2000 以降のプロトコルでは、カーネル モード サポート ルーチンを呼び出して、独自のプロトコル固有のレジストリ キーを開きます。 これらのサポート ルーチンの詳細については、「Kernel-Mode サポート ルーチンと電源管理サポート ルーチンの概要」を参照してください。

  • ターゲット プラットフォーム: ユニバーサル
  • バージョン: Windows Vista の NDIS 6.0 ドライバーではサポートされていません。 代わりに NdisOpenConfigurationExを使用してください。 Windows Vista および Windows XP の NDIS 5.1 ドライバーでサポートされています。

要件

要件 値
Header ndis.h (Ndis.h を含む)
Library Ndis.lib
IRQL PASSIVE_LEVEL

こちらもご覧ください