Registrieren einer Erweiterungsschnittstelle

Nachdem eine WSK-Anwendung (Winsock Kernel) erfolgreich einen Socket erstellt hat, kann sie diesen Socket für eine oder mehrere der Erweiterungsschnittstellen registrieren, die vom WSK-Subsystem unterstützt werden. Eine WSK-Anwendung bestimmt, welche Erweiterungsschnittstellen vom WSK-Subsystem unterstützt werden, indem sie den Versionsmember der WSK_PROVIDER_DISPATCH Struktur untersucht, die das WSK-Subsystem während der Anlage an die Anwendung zurückgegeben hat.

Jede Erweiterungsschnittstelle wird durch einen NPI definiert, der vom WSK-NPI unabhängig ist. Beachten Sie jedoch, dass die NPIs für Erweiterungsschnittstellen keine NPI-spezifischen Merkmale unterstützen.

Eine WSK-Anwendung registriert sich für eine Erweiterungsschnittstelle, indem sie den SIO_WSK_REGISTER_EXTENSION Socket-IOCTL-Vorgang für den Socket ausführt. Weitere Informationen zum Ausführen von Socket-IOCTL-Vorgängen finden Sie unter Ausführen von Steuerungsvorgängen für einen Socket.

Wenn eine WSK-Anwendung versucht, einen Socket für eine Erweiterungsschnittstelle zu registrieren, die vom WSK-Subsystem nicht unterstützt wird, gibt der SIO_WSK_REGISTER_EXTENSION Socket-IOCTL-Vorgang STATUS_NOT_SUPPORTED zurück.

Angenommen, eine Erweiterungsschnittstelle ist wie im folgenden Codebeispiel definiert.

const NPIID EXAMPLE_EXTIF_NPIID = {...};

typedef struct _EXAMPLE_EXTIF_PROVIDER_DISPATCH {
  .
  . // Function pointers for the functions that are
  . // defined by the extension interface.
  .
} EXAMPLE_EXTIF_PROVIDER_DISPATCH, *PEXAMPLE_EXTIF_PROVIDER_DISPATCH;

typedef struct _EXAMPLE_EXTIF_CLIENT_DISPATCH {
  .
  . // Function pointers for the callback functions
  . // that are defined by the extension interface.
  .
} EXAMPLE_EXTIF_CLIENT_DISPATCH, *PEXAMPLE_EXTIF_CLIENT_DISPATCH;

Im Folgenden wird gezeigt, wie eine WSK-Anwendung sich für diese Erweiterungsschnittstelle für einen verbindungsorientierten Socket registrieren kann.

// Client dispatch structure for the extension interface
const EXAMPLE_EXTIF_CLIENT_DISPATCH ExtIfClientDispatch = {
  .
  . // The WSK application's callback functions
  . // for the extension interface
  .
};

// Context structure type for the example extension interface
typedef struct _EXAMPLE_EXTIF_CLIENT_CONTEXT
{
  const EXAMPLE_EXTIF_PROVIDER_DISPATCH *ExtIfProviderDispatch;
  PVOID ExtIfProviderContext;
    .
    .  // Other application-specific members
    .
} EXAMPLE_EXTIF_CLIENT_CONTEXT, *PEXAMPLE_EXTIF_CLIENT_CONTEXT;

// Function to register the example extension interface
NTSTATUS
  RegisterExampleExtIf(
    PWSK_SOCKET Socket,
    PEXAMPLE_EXTIF_CLIENT_CONTEXT ExtIfClientContext
    )
{
  PWSK_PROVIDER_CONNECTION_DISPATCH Dispatch;
  WSK_EXTENSION_CONTROL_IN ExtensionControlIn;
  WSK_EXTENSION_CONTROL_OUT ExtensionControlOut;
  NTSTATUS Status;

  // Get pointer to the socket's provider dispatch structure
  Dispatch =
    (PWSK_PROVIDER_CONNECTION_DISPATCH)(Socket->Dispatch);

  // Fill in the WSK_EXTENSION_CONTROL_IN structure
  ExtensionControlIn.NpiId = &EXAMPLE_EXTIF_NPIID;
  ExtensionControlIn.ClientContext = ExtIfClientContext;
  ExtensionControlIn.ClientDispatch = &ExtIfClientDispatch;

  // Initiate the IOCTL operation on the socket
  Status =
    Dispatch->WskControlSocket(
      Socket,
      WskIoctl,
      SIO_WSK_REGISTER_EXTENSION,
      0,
      sizeof(WSK_EXTENSION_CONTROL_IN),
      &ExtensionControlIn,
      sizeof(WSK_EXTENSION_CONTROL_OUT),
      &ExtensionControlOut,
      NULL,
      NULL  // No IRP used for this IOCTL operation
      );

  // Check result
  if (Status == STATUS_SUCCESS)
  {
    // Save provider dispatch table and provider context
    ExtIfClientContext->ExtIfProviderDispatch =
      (const EXAMPLE_EXTIF_PROVIDER_DISPATCH *)
        ExtensionControlOut.ProviderDispatch;
    ExtIfClientContext->ExtIfProviderContext =
      ExtensionControlOut.ProviderContext;
  }

  // Return the status of the call to WskControlSocket()
  return Status;
}

Eine WSK-Anwendung registriert sich für Erweiterungsschnittstellen auf Socket-by-Socket-Basis.