wskCaptureProviderNPI 函式 (wsk.h)
WskCaptureProviderNPI 函式會在從 WSK 子系統取得時，擷取提供者網路程序設計介面 (NPI) 。
語法
NTSTATUS WskCaptureProviderNPI(
[in] PWSK_REGISTRATION WskRegistration,
[in] ULONG WaitTimeout,
[out] PWSK_PROVIDER_NPI WskProviderNpi
);
參數
[in] WskRegistration
WskRegister 所初始化之內存位置的指標，可識別 WSK 應用程式的註冊實例。 如需詳細資訊，請參閱 WSK_REGISTRATION。
[in] WaitTimeout
WskCaptureProviderNPI 函式可以使用的時間，以毫秒為單位，等到 WSK 提供者 NPI 可用為止。 或者，您可以指定下列專案：
WSK_NO_WAIT
如果提供者 NPI 無法使用，請立即從此函式傳回。
WSK_INFINITE_WAIT
等候提供者 NPI 可從 WSK 子系統取得。
如需如何使用此參數的詳細資訊，請參閱 註冊 Winsock 核心應用程式。
[out] WskProviderNpi
WSK 提供者所傳回之 NPI 的指標。 此 WSK_PROVIDER_NPI 結構包含 WSK 應用程式可以呼叫之 WSK 函式 WSK 提供者分派數據表的指標。
傳回值
WskCaptureProviderNPI 會傳回下列其中一個 NTSTATUS 代碼：
| 傳回碼 | Description |
|---|---|
|
提供者 NPI 擷取已成功完成。 |
|
提供者 NPI 尚未提供。 |
|
WSK 子系統不支援 WSK 用戶端所要求的版本。 |
|
提供者 NPI 擷取失敗。 |
備註
對於每個傳回成功碼的 WskCaptureProviderNPI 呼叫，都必須有一個對應的 WskReleaseProviderNPI 呼叫，其使用傳遞至 WskCaptureProviderNPI 的相同 WskRegistration 參數。
只有在未釋放或覆寫 WskRegistration 區塊時，才能呼叫 WskCaptureProviderNPI 呼叫 WskDeregister。 呼叫 WskDeregister 之後，對 WskCaptureProviderNPI 的任何進一步呼叫都會 STATUS_DEVICE_NOT_READY失敗，而且除非提供者 NPI 同時可用，否則在等候 WSK 提供者 NPI 變成可用的其他線程中封鎖的任何現有 WskCaptureProviderNPI 呼叫，也會立即傳回狀態代碼STATUS_DEVICE_NOT_READY。
如需將 WSK 應用程式附加至 WSK 子系統的詳細資訊，請參閱 註冊 Winsock 核心應用程式。
如果 WaitTimeout 未設定為 WSK_NO_WAIT，WskCaptureProviderNPI 函式的呼叫端必須在 IRQL = PASSIVE_LEVEL執行;否則，呼叫端必須在 IRQL <= DISPATCH_LEVEL上執行。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
| 目標平台 | Universal |
| 標頭 | wsk.h (包含 Wsk.h) |
| 程式庫 | Netio.lib |
| IRQL | PASSIVE_LEVEL (请参阅一节) |