共用方式為

NmrRegisterClient 函式 (netioddk.h)

  • 發行項

NmrRegisterClient 函式會向NMR註冊客戶端模組。

語法

NTSTATUS NmrRegisterClient(
  [in]  PNPI_CLIENT_CHARACTERISTICS ClientCharacteristics,
  [in]  __drv_aliasesMem PVOID      ClientContext,
  [out] PHANDLE                     NmrClientHandle
);

參數

[in] ClientCharacteristics

的指標 描述 客戶端模組特性的NPI_CLIENT_CHARACTERISTICS結構。 只要客戶端模組向 NMR 註冊，用戶端模組就必須確保此結構保持有效且保留在記憶體中。

[in] ClientContext

註冊之呼叫端所提供內容的指標。 用戶端模組會使用此內容來追蹤客戶端註冊的狀態。 用戶端模組的註冊內容與NMR不透明。 每當NMR呼叫用戶端模組的 ClientAttachProvider 回呼函式時，就會將此指標傳遞至用戶端模組。 只要客戶端模組向 NMR 註冊，用戶端模組必須確定其註冊內容保持有效且保留在記憶體中。

[out] NmrClientHandle

接收NMR用來表示客戶端模組註冊之句柄之變數的指標。 用戶端模組必須儲存此句柄，並將它當做參數傳遞至 NmrDeregisterClient 函式時，從NMR取消註冊。

傳回值

NmrRegisterClient 函式會傳回下列其中一個 NTSTATUS 代碼：

傳回碼 Description
STATUS_SUCCESS
 NMR 已成功註冊客戶端模組。
STATUS_INSUFFICIENT_RESOURCES
 NMR 沒有足夠的系統資源可註冊客戶端模組。
其他狀態代碼
 發生錯誤。

備註

用戶端模組會呼叫 NmrRegisterClient 函式，以註冊為 NPI 的用戶端，以便附加至註冊為相同 NPI 提供者的提供者模組。

用戶端模組通常會在完成所有其他初始化工作之後，從其 DriverEntry 函式呼叫 NmrRegisterClient 函式。 NmrRegisterClient 函式的呼叫會向NMR指出用戶端模組已準備好附加至任何已註冊的提供者模組，或將註冊為用戶端模組註冊為用戶端之相同NPI的提供者。

規格需求

需求 值
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
目標平台 桌面
標頭 netioddk.h (包含 Wsk.h)
程式庫 Netio.lib
IRQL PASSIVE_LEVEL

另請參閱

DriverEntry

NPI_CLIENT_CHARACTERISTICS

NmrDeregisterClient