NmrRegisterProvider 函式 (netioddk.h)
NmrRegisterProvider 函式會向NMR註冊提供者模組。
語法
NTSTATUS NmrRegisterProvider(
[in] PNPI_PROVIDER_CHARACTERISTICS ProviderCharacteristics,
[in] __drv_aliasesMem PVOID ProviderContext,
[out] PHANDLE NmrProviderHandle
);
參數
[in] ProviderCharacteristics
的指標 NPI_PROVIDER_CHARACTERISTICS 結構，描述提供者模組的特性。 只要提供者模組向NMR註冊，提供者模組就必須確保此結構保持有效且保留在記憶體中。
[in] ProviderContext
註冊之呼叫端所提供內容的指標。 提供者模組會使用此內容來追蹤提供者註冊的狀態。 提供者模組的註冊內容與NMR不透明。 NMR 會在呼叫提供者模組的 ProviderAttachClient 回呼函式時，將此指標傳遞至提供者模組。 提供者模組必須確定只要提供者模組向NMR註冊，此內容就會保持有效且保留在記憶體中。
[out] NmrProviderHandle
接收NMR用來表示提供者模組註冊之句柄之變數的指標。 提供者模組必須儲存此句柄，並在從NMR取消註冊時將其當做參數傳遞至 NmrDeregisterProvider 函式。
傳回值
NmrRegisterProvider 函式會傳回下列其中一個 NTSTATUS 代碼：
| 傳回碼 | Description |
|---|---|
|
NMR 已成功註冊提供者模組。 |
|
NMR 沒有足夠的系統資源可註冊提供者模組。 |
|
發生錯誤。 |
備註
提供者模組會呼叫 NmrRegisterProvider 函式，以註冊為 NPI 的提供者，以便附加至註冊為相同 NPI 用戶端的客戶端模組。
提供者模組通常會在完成所有其他初始化工作之後，從其 DriverEntry 函式呼叫 NmrRegisterProvider 函式。 NmrRegisterProvider 函式的呼叫會向NMR指出提供者模組已準備好附加至任何已註冊的用戶端模組，或將註冊為提供者模組註冊為提供者的相同 NPI 用戶端。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
| 目標平台 | 桌面 |
| 標頭 | netioddk.h (包含 Wsk.h) |
| 程式庫 | Netio.lib |
| IRQL | PASSIVE_LEVEL |