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版本。 網路模組應將此成員設定為零。
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 註冊, 成員就會保持有效且常駐於記憶體中。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows作系統中使用。 |
標頭 | netioddk.h (包括 Wsk.h) |