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 は、cleint モジュールの 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 を含む)

こちらもご覧ください

ClientAttachProvider

NPI_CLIENT_CHARACTERISTICS

NPI_MODULEID

NPI_PROVIDER_CHARACTERISTICS

ProviderAttachClient