Funzione UcmConnectorPowerDirectionChanged (ucmmanager.h)

  • Articolo

Notifica all'estensione del framework di gestione connettori USB (UcmCx) il nuovo ruolo di alimentazione del connettore partner.

Sintassi

void UcmConnectorPowerDirectionChanged(
  [in] UCMCONNECTOR   Connector,
  [in] BOOLEAN        Success,
  [in] UCM_POWER_ROLE CurrentPowerRole
);

Parametri

[in] Connector

Gestire l'oggetto connettore ricevuto dal driver client nella chiamata precedente a UcmConnectorCreate.

[in] Success

Usato per indicare l'errore di uno scambio di ruoli di alimentazione avviato da UcmCx tramite EVT_UCM_CONNECTOR_SET_POWER_ROLE.

Se TRUE, l'operazione ha avuto esito positivo. FALSE, in caso contrario.

[in] CurrentPowerRole

Uno dei flag tipizzato di UCM_POWER_ROLE che indica il nuovo ruolo dati.

Valore restituito

nessuno

Osservazioni

UcmConnectorPowerDirectionChanged restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa funzione inline può restituire un valore NTSTATUS appropriato.

Se il partner connettore è collegato, UcmCx aggiorna il ruolo di alimentazione del partner a seconda del valore CurrentPowerRole .

UcmCx può modificare il ruolo di alimentazione di un connettore e richiama EVT_UCM_CONNECTOR_SET_POWER_ROLE. In risposta a tale chiamata, il client deve eseguire l'operazione di PR_Swap e indicare l'esito positivo/negativo dell'operazione chiamando UcmConnectorPowerDirectionChanged.

In alternativa, il driver client potrebbe scegliere di eseguire uno scambio di ruoli in modo autonomo oppure il partner potrebbe eseguire uno scambio di ruoli. In entrambi i casi, al termine dello scambio di ruoli, il driver deve segnalare il nuovo ruolo a UcmCx usando UcmConnectorPowerDirectionChanged.

Requisiti

Requisito Valore
Client minimo supportato Windows 10
Server minimo supportato Windows Server 2016
Piattaforma di destinazione Windows
Versione KMDF minima 1.15
Versione UMDF minima 2.15
Intestazione ucmmanager.h (include Ucmcx.h)
Libreria UcmCxstub.lib
IRQL PASSIVE_LEVEL

Vedi anche