Interfaccia IUnregisterPhysicalConnection (portcls.h)

  • Articolo

L'interfaccia IUnregisterPhysicalConnection implementa tre metodi per rimuovere una connessione fisica registrata. Il driver della porta implementa questa interfaccia. Per determinare se un driver di porta supporta l'interfaccia IUnregisterPhysicalConnection , un driver miniport chiama il metodo QueryInterface dell'oggetto driver di porta con REFIID IID_IUnregisterPhysicalConnection. Il driver miniport è responsabile del rilascio dell'oggetto IUnregisterPhysicalConnection dopo che non è più necessario. L'interfaccia IUnregisterPhysicalConnection eredita da IUnknown.

I driver di porta seguenti supportano l'interfaccia IUnregisterSubdevice :

  • WaveCyclic
  • WavePci
  • Topologia
  • DMus
  • MIDI
I tre metodi in questa interfaccia "annullano la registrazione" delle connessioni fisiche registrate in precedenza dalle chiamate alle routine PcRegisterPhysicalConnection, PcRegisterPhysicalConnectionFromExternal o PcRegisterPhysicalConnectionToExternal . PortCls supporta le tre routine PcRegisterPhysicalConnectionXxx .

Il driver di porta usa le informazioni ottenute dalle chiamate PcRegisterPhysicalConnectionXxx per rispondere alle richieste di proprietà KSPROPERTY_PIN_PHYSICALCONNECTION .

Quando si elimina un sottodispositivo dalla topologia di un adattatore, il driver deve annullare la registrazione delle connessioni fisiche del sottodispositivo a tale parte della topologia. L'impossibilità di annullare la registrazione delle connessioni fisiche del dispositivo secondario può causare perdite di memoria.

Ereditarietà

L'interfaccia IUnregisterPhysicalConnection eredita dall'interfaccia IUnknown . IUnregisterPhysicalConnection include anche questi tipi di membri:

Metodi

L'interfaccia IUnregisterPhysicalConnection include questi metodi.

 
IUnregisterPhysicalConnection::UnregisterPhysicalConnection

Il metodo UnregisterPhysicalConnection elimina la registrazione di una connessione fisica registrata da una chiamata precedente a PcRegisterPhysicalConnection.
IUnregisterPhysicalConnection::UnregisterPhysicalConnectionFromExternal

Il metodo UnregisterPhysicalConnectionFromExternal elimina la registrazione di una connessione fisica registrata da una chiamata precedente a PcRegisterPhysicalConnectionFromExternal.
IUnregisterPhysicalConnection::UnregisterPhysicalConnectionToExternal

Il metodo UnregisterPhysicalConnectionToExternal elimina la registrazione di una connessione fisica registrata da una precedente chiamata a PcRegisterPhysicalConnectionToExternal.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione portcls.h