Função UcmTcpciPortControllerStop (ucmtcpciportcontroller.h)
Indica à extensão de classe UcmTcpciCx parar de enviar solicitações de hardware para o objeto do controlador de porta.
Sintaxe
void UcmTcpciPortControllerStop(
UCMTCPCIPORTCONTROLLER PortControllerObject
);
Parâmetros
PortControllerObject
Manipule para o objeto do controlador de porta que o driver cliente recebeu na chamada anterior para ucmTcpciPortControllerCreate.
Valor de retorno
Nenhum
Observações
Depois de chamar UcmTcpciPortControllerStop, o driver cliente para de processar todas as solicitações no objeto do controlador de porta. Essa chamada é síncrona, portanto, é garantido que a extensão de classe não invocará funções de retorno de chamada ou enviará solicitações depois de retornar. O driver não deve chamar esse método em um retorno de chamada do controlador de porta ou enquanto quaisquer solicitações de hardware não canceláveis estiverem pendentes.
Um driver cliente chama esse método de sua implementação de retorno de chamada EVT_WDF_DEVICE_RELEASE_HARDWARE. Depois de fazer isso, ele também deve chamar WdfObjectDelete, caso EVT_WDF_DEVICE_RELEASE_HARDWARE seja invocado para o reequilíbrio de recursos. A falha ao fazer isso faz com que o driver vaze objetos associados ao objeto do controlador de porta quando ocorre um reequilíbrio de recurso. A criação da alça UCMPORTCONTROLLER para o identificador WDFDEVICE não é suficiente, pois um WDFDEVICE não é excluído em um reequilíbrio de recursos.
Se o driver estiver fazendo a transição para um estado Dx devido a S0-Idle, o driver não deverá chamar esse método de sua função de retorno de chamada EVT_WDF_DEVICE_D0_EXIT. A sincronização com o estado de energia do driver pode ser obtida usando uma fila gerenciada por energia para receber solicitações de hardware.
É seguro chamar UcmTcpciPortControllerStop em um controlador de porta que já foi interrompido. Depois que esse método é retornado, nenhum outro método, exceto UcmTcpciPortControllerStart pode ser chamado no controlador de porta.
O driver cliente deve chamar esse método se precisar interromper todas as ações no controlador de porta para que ele possa executar a recuperação de erro se tiver detectado problemas durante sua operação. Depois que o processo de recuperação for concluído, o driver deverá reiniciar o controlador de porta.
Parar o controlador encerra qualquer contrato PD ativo e a conexão Type-C.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 10 |
| servidor com suporte mínimo | Windows Server 2016 |
| da Plataforma de Destino | Windows |
| cabeçalho | ucmtcpciportcontroller.h |
| biblioteca | Ucmtcpcicxstub.lib |
| IRQL | PASSIVE_LEVEL |