HSPluginInitPlugin, funkcja

Wi-Fi Nota dotycząca wycofywania odciążania hotspotu

Ważny

Począwszy od systemu Windows 10 w wersji 1709, funkcja odciążania hotspotu Wi-Fi jest przestarzała i nie powinna być używana. Zamiast tego zalecamy napisanie aplikacji platformy UWP i użycie interfejsu API uwierzytelniania hotspotu Wi-Fi (Windows.Networking.NetworkOperators).

Aby uzyskać przykładowy kod i więcej informacji, zobacz przykład uwierzytelniania hotspotu Wi-Fi.

Funkcja HSPluginInitPluginPlugin jest eksportowana przez bibliotekę DLL wtyczki i wywoływana w celu zainicjowania wtyczki.

Składnia

DWORD HSPluginInitPlugin(
  _In_  HANDLE                hPluginContext,
  _In_  DWORD                 dwVerNumUsed,
  _In_  DWORD                 dwHostCapabilities,
  _In_  HS_DEVICE_IDENTITY    *pDeviceIdentity,
  _In_  HOTSPOT_HOST_HANDLERS *pHotspotHostHandlers,
  _Out_ HOTSPOT_PLUGIN_APIS   *pHotspotPluginAPIs,
  _Out_ HS_PLUGIN_PROFILE     *pPluginProfile
);

Parametry

hPluginContext [in]
Uchwyt dostarczony przez hosta, że wtyczka jest wymagana do zapisania, a następnie użycia, gdy musi wysłać żądanie do hosta za pomocą funkcji obsługi hosta.

dwVerNumUsed [in]
Bieżący numer wersji hosta.

dwHostCapabilities [in]
Wartość określająca listę możliwości, które host może udostępnić wtyczki. Ta wartość jest bitowa LUB kombinacja odpowiednich flag możliwości. Aby uzyskać więcej informacji na temat flag możliwości, zobacz HS_FLAG_CAPABILITY_\* stałe w Wi-Fi Hotspot Offloading Constants.

Uwaga Jeśli host nie dostarcza wszystkich możliwości wymaganych przez wtyczkę, wtyczka nie zostanie zainicjowana.

*pDeviceIdentity [in]
Wskaźnik do struktury HS_DEVICE_IDENTITY zawierającej informacje o producencie i modelu urządzenia.

*pHotspotHostHandlers [in]
Wskaźnik do struktury HOTSPOT_HOST_HANDLERS zawierającej tabelę funkcji obsługi hostów hotspotów. Ta tabela zawiera wskaźniki do funkcji wywoływanych przez wtyczkę w celu komunikowania się z hostem hotspotu.

*pHotspotPluginAPIs [out]
Wskaźnik do struktury HOTSPOT_PLUGIN_APIS zawierającej tabelę funkcji interfejsów API wtyczek hotspotu. Ta tabela jest zwracana przez wtyczkę i zawiera wskaźniki do funkcji wywoływanych przez hosta w celu komunikowania się z wtyczką.

*pPluginProfile [out]
Wskaźnik do struktury HS_PLUGIN_PROFILE zwróconej przez wtyczkę, która zawiera informacje o wtyczce.

Uwagi

Podczas inicjowania host udostępnia następujące elementy:

  • Uchwyt kontekstu wtyczki
  • Bieżący numer wersji
  • Lista możliwości, które host może udostępnić wtyczki
  • Wskaźnik do tabeli funkcji obsługi hosta, za pomocą której wtyczka może komunikować się z hostem

Wtyczka zwraca wskaźnik do własnej tabeli funkcji i wskaźnik do struktury HS_PLUGIN_PROFILE.

Wymagania

Wersja

Windows 10 Mobile

Nagłówek

Hotspotoffloadplugin.h (include Hotspotoffloadplugin.h)

Zobacz też

Wi-Fi Stałe odciążania hotspotów

HS_DEVICE_IDENTITY

HOTSPOT_HOST_HANDLERS

HOTSPOT_PLUGIN_APIS

HS_PLUGIN_PROFILE