Creazione di sottodispositivi

Il termine subdevice viene usato per descrivere l'associazione dei quattro componenti elencati nella tabella seguente.

Le interfacce IMiniportXxx e IPortXxx di un subdevice ereditano rispettivamente da interfacce di base IMiniport e IPort.

Il driver di sistema PortCls non distingue tra il driver di porta e il driver miniport. Richiede semplicemente un oggetto, ad esempio l'oggetto porta, con un'interfaccia che può gestire le richieste generate dal sistema.

Analogamente, PortCls non è direttamente coinvolto nella gestione delle risorse. Deve associare solo il gestore della richiesta (il driver della porta) a un elenco di risorse. Il driver dell'adattatore è responsabile dell'associazione tra gli oggetti porta, miniport e elenco risorse.

Nell'esempio di codice seguente viene illustrato come il driver dell'adapter esegue queste azioni:

  //
  // Instantiate the port by calling a function supplied by PortCls.
  //
  PPORT    port;
  NTSTATUS ntStatus = PcNewPort(&port, PortClassId);

  if (NT_SUCCESS(ntStatus))
  {
      PUNKNOWN miniport;
      //
      // Create the miniport object.
      //
      if (MiniportCreate)   // a function to create a proprietary miniport
      {
          ntStatus = MiniportCreate(&miniport,
                                    MiniportClassId, NULL, NonPagedPool);
      }
      else   // Ask PortCls for one of its built-in miniports.
      {
          ntStatus = PcNewMiniport((PMINIPORT*)&miniport,
                                   MiniportClassId);
      }

      if (NT_SUCCESS(ntStatus))
      {
          //
          // Bind the port, miniport, and resources.
          //
          ntStatus = port->Init(DeviceObject,
                                Irp, miniport, UnknownAdapter, ResourceList);
          if (NT_SUCCESS(ntStatus))
          {
              //
              // Hand the port driver and the reference
              // string to PortCls.
              //
              ntStatus = PcRegisterSubdevice(DeviceObject,
                                             Name, port);
          }

          //
          // We no longer need to reference the miniport driver.
          // Either the port driver now references it,
          // or binding failed and it should be deleted.
          //
          miniport->Release();
      }

      //
      // Release the reference that existed when PcNewPort() gave us
      // the pointer in the first place. This reference must be released
      // regardless of whether the binding of the port and miniport
      // drivers succeeded.
      //
      port->Release();
  }

Per informazioni sulle chiamate della funzione PortCls nell'esempio di codice precedente, vedere PcNewPort, PcNewMiniport e PcRegisterSubdevice.