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に登録するために使用されます。
クライアント モジュールの ClientAttachProvider コールバック関数を呼び出すと、クライアント モジュールが自身をアタッチできるプロバイダー モジュールのNPI_REGISTRATION_INSTANCE構造体へのポインターが渡されます。 同様に、NMR はプロバイダー モジュールの ProviderAttachClient コールバック関数を呼び出すと、プロバイダー モジュールが自身をアタッチできるクライアント モジュールのNPI_REGISTRATION_INSTANCE構造体へのポインターを渡します。
ネットワーク モジュールは、NpiId が指す NPIID のメモリ メンバーであることを確認する必要があります。 ModuleId メンバーが指す NPI_MODULEID 構造体のメモリと、NpiSpecificCharacteristics メンバーが指す NPI固有の特性構造のメモリは、ネットワーク モジュールがNMR に登録されている限り、有効であり、メモリ内に常駐します。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| ヘッダー | netioddk.h (Wsk.h を含む) |