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 |