次の方法で共有

NdisOpenProtocolConfiguration 関数 (ndis.h)

  • [アーティクル]

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

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 サポート ルーチンの の概要」 および Power Management サポート ルーチンのを参照してください。

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

必要条件

要件 価値
ヘッダー ndis.h (Ndis.h を含む)
ライブラリ Ndis.lib
IRQL PASSIVE_LEVEL

関連項目