NPI_REGISTRATION_INSTANCE 結構 (netioddk.h)

發行項
02/26/2024

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版本。網路模組應該將此成員設定為零。

Size

NPI_REGISTRATION_INSTANCE 結構的大小，以位元組為單位。

NpiId

網路模組註冊為用戶端或提供者之特定 NPI 之 NPI 識別碼的指標。 NPIID 資料類型定義為：

typedef GUID NPIID;
typedef CONST NPIID *PNPIID;

ModuleId

可唯一識別網路模組之NPI_MODULEID 結構的指標。

Number

網路模組註冊為用戶端或提供者之 NPI 的實作編號。網路模組可以藉由註冊為用戶端或每個 NPI 實作的提供者，來支援相同 NPI 的多個實作。如果 NPI 只有一個實作，此成員會設定為零。

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 註冊，記憶體中就會保持有效且駐留在記憶體中。