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 |