Een extensie-interface registreren

Nadat een Winsock Kernel-toepassing (WSK) een socket heeft gemaakt, kan deze socket worden geregistreerd voor een of meer van de uitbreidingsinterfaces die worden ondersteund door het WSK-subsysteem. Een WSK-toepassing bepaalt welke set uitbreidingsinterfaces door het WSK-subsysteem wordt ondersteund door het lid versienummer van de structuur WSK_PROVIDER_DISPATCH die het WSK-subsysteem aan de toepassing heeft geretourneerd tijdens de koppeling.

Elke extensie-interface wordt gedefinieerd door een NPI die onafhankelijk is van de WSK NPI. Houd er echter rekening mee dat de NPI's voor extensie-interfaces geen ondersteuning bieden voor NPI-specifieke kenmerken.

Een WSK-toepassing registreert zich voor een extensie-interface door de SIO_WSK_REGISTER_EXTENSION socket-IOCTL-bewerking op de socket uit te voeren. Zie Besturingsbewerkingen uitvoeren op een socket-voor meer informatie over het uitvoeren van socket-IOCTL-bewerkingen.

Als een WSK-toepassing probeert een socket te registreren voor een extensie-interface die niet wordt ondersteund door het WSK-subsysteem, retourneert de SIO_WSK_REGISTER_EXTENSION socket-IOCTL-bewerking STATUS_NOT_SUPPORTED.

Stel dat een extensie-interface is gedefinieerd zoals in het volgende codevoorbeeld.

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;

Hieronder ziet u hoe een WSK-toepassing zich kan registreren voor deze extensie-interface voor een verbindingsgeoriënteerde socket.

// 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;
}

Een WSK-toepassing registreert zich voor extensie-interfaces per socket.