NPI_REGISTRATION_INSTANCE 構造体 (netioddk.h)
NPI_REGISTRATION_INSTANCE構造は、ネットワークモジュールのNMRへの登録に関連するデータを定義します。
構文
typedef struct _NPI_REGISTRATION_INSTANCE {
USHORT Version;
USHORT Size;
PNPIID NpiId;
PNPI_MODULEID ModuleId;
ULONG Number;
const VOID *NpiSpecificCharacteristics;
} NPI_REGISTRATION_INSTANCE;
メンバー
Version
ネットワーク モジュールが登録されている NMR のバージョン。 ネットワーク モジュールでは、このメンバーを 0 に設定する必要があります。
Size
NPI_REGISTRATION_INSTANCE構造体のサイズ (バイト単位)。
NpiId
ネットワーク モジュールがクライアントまたはプロバイダーとして登録されている特定の NPI の NPI 識別子へのポインター。 NPIID データ型は次のように定義されます。
typedef GUID NPIID;
typedef CONST NPIID *PNPIID;
ModuleId
ネットワーク モジュールを一意に識別する NPI_MODULEID 構造体へのポインター。
Number
ネットワーク モジュールがクライアントまたはプロバイダーとして登録されている NPI の実装番号。 ネットワーク モジュールは、NPI の各実装のクライアントまたはプロバイダーとして登録することで、同じ NPI の複数の実装をサポートできます。 NPI の実装が 1 つだけの場合、このメンバーは 0 に設定されます。
NpiSpecificCharacteristics
ネットワーク モジュールに固有の特性を指定する構造体へのポインター。 構造体の内容は NPI 固有です。 ネットワーク モジュールは、クライアント特性構造を定義しない NPI のクライアントとして登録する場合、またはプロバイダー特性構造を定義しない NPI のプロバイダーとして登録する場合は、このメンバーを NULL に設定する必要があります。
注釈
NPI_REGISTRATION_INSTANCE構造体は、 NPI_CLIENT_CHARACTERISTICS のメンバーであり、 NPI_PROVIDER_CHARACTERISTICS 構造体。 これらの構造は、ネットワークモジュールをNMRに登録するために使用される。
NMR は、クライアント モジュールの ClientAttachProvider コールバック関数を呼び出すと、クライアント モジュールが自身をアタッチできるプロバイダー モジュールのNPI_REGISTRATION_INSTANCE構造体へのポインターを渡します。 同様に、NMR はプロバイダー モジュールの ProviderAttachClient コールバック関数を呼び出すと、プロバイダー モジュールが自身をアタッチできるクライアント モジュールのNPI_REGISTRATION_INSTANCE構造体へのポインターを渡します。
ネットワーク モジュールでは、NpiId メンバーが指す NPIID のメモリ、ModuleId メンバーが指すNPI_MODULEID構造体のメモリ、NpiSpecificCharacteristics メンバーが指す NPI 固有の特性構造のメモリが、ネットワーク モジュールが NMR に登録されている限り、有効であり、メモリ内に常駐していることを確認する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| Header | netioddk.h (Wsk.h を含む) |