Funzione UcmTcpciPortControllerStop (ucmtcpciportcontroller.h)

Indica all'estensione della classe UcmTcpciCx per interrompere l'invio di richieste hardware all'oggetto controller di porta.

Sintassi

void UcmTcpciPortControllerStop(
  UCMTCPCIPORTCONTROLLER PortControllerObject
);

Parametri

PortControllerObject

Gestire l'oggetto controller di porta ricevuto dal driver client nella chiamata precedente a UcmTcpciPortControllerCreate.

Valore restituito

nessuno

Osservazioni

Dopo aver chiamato UcmTcpciPortControllerStop, il driver client interrompe l'elaborazione di tutte le richieste nell'oggetto controller di porta. Questa chiamata è sincrona, pertanto è garantito che l'estensione della classe non richiami le funzioni di callback o invii richieste dopo che viene restituita. Il driver non deve chiamare questo metodo all'interno di un callback del controller di porta o mentre le richieste hardware non annullabili sono in sospeso.

Un driver client chiama questo metodo dalla relativa implementazione di callback EVT_WDF_DEVICE_RELEASE_HARDWARE. In seguito, deve anche chiamare WdfObjectDelete, nel caso in cui EVT_WDF_DEVICE_RELEASE_HARDWARE venga richiamato al ribilanciamento delle risorse. In caso contrario, il driver perde oggetti associati all'oggetto controller di porta quando si verifica un ribilanciamento della risorsa. L'elemento padre dell'handle UCMPORTCONTROLLER per l'handle WDFDEVICE non è sufficiente perché un WDFDEVICE non viene eliminato in una risorsa ribilanciamento.

Se il driver passa a uno stato Dx a causa di S0-Idle, il driver non deve chiamare questo metodo dalla relativa funzione di callback EVT_WDF_DEVICE_D0_EXIT. È possibile ottenere la sincronizzazione con lo stato di alimentazione del driver usando una coda gestita dall'alimentazione per ricevere richieste hardware.

È possibile chiamare UcmTcpciPortControllerStop su un controller di porta già arrestato. Al termine di questo metodo, non è possibile chiamare alcun altro metodo, ad eccezione di UcmTcpciPortControllerStart sul controller della porta.

Il driver client deve chiamare questo metodo se deve arrestare tutte le azioni nel controller della porta in modo che possa eseguire il ripristino degli errori se ha rilevato problemi durante l'operazione. Al termine del processo di ripristino, il driver deve riavviare il controller della porta.

L'arresto del controller termina qualsiasi contratto PD attivo e la connessione Type-C.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10
Server minimo supportato	Windows Server 2016
Piattaforma di destinazione	Windows
Intestazione	ucmtcpciportcontroller.h
Libreria	Ucmtcpcicxstub.lib
IRQL	PASSIVE_LEVEL

Vedi anche

UcmTcpciPortControllerStart