Funzione UfxDevicePortDetectCompleteEx (ufxclient.h)

Articolo
02/29/2024

Notifica UFX al tipo di porta rilevato e richiede facoltativamente un'azione.

Sintassi

void UfxDevicePortDetectCompleteEx(
  [in] UFXDEVICE       UfxDevice,
  [in] USBFN_PORT_TYPE PortType,
  [in] USBFN_ACTION    Action
);

Parametri

[in] UfxDevice

Handle a un oggetto dispositivo UFX creato dal driver chiamando UfxDeviceCreate.

[in] PortType

Contiene un valore di enumerazione di tipo USBFN_PORT_TYPE.

[in] Action

Contiene un valore di enumerazione di tipo USBFN_ACTION.

Valore restituito

nessuno

Osservazioni

Il driver client chiama UfxDevicePortDetectCompleteEx dopo il completamento del rilevamento delle porte, in genere dalla sua funzione di callback EVT_UFX_DEVICE_PORT_DETECT . In alcune piattaforme, UFX può usare il tipo di porta segnalato per notificare al gestore della batteria il massimo corrente che può disegnare dalla porta USB.

Se il parametro Action è impostato su UsbfnActionNoCad, UFX non invia alcuna notifica al gestore della batteria.

Se il parametro Action è impostato su UsbfnActionDetectProprietaryCharger, UFX richiede che il driver client avvia il rilevamento del caricatore proprietario chiamando la funzione di callback del driver client EVT_UFX_DEVICE_DETECT_PROPRIETARY_CHARGER.

Il frammento di codice seguente illustra come un driver client chiama UfxDevicePortDetectCompleteEx.

    switch (OnAttach.AttachAction) {
    case UsbfnPortDetected:
        TraceInformation("Port Detected");
        UfxDevicePortDetectComplete(
            ControllerData->UfxDevice,
            OnAttach.PortType);

        break;

    case UsbfnPortDetectedNoCad:
        TraceInformation("Port Detected No CAD");
        UfxDevicePortDetectCompleteEx(
            ControllerData->UfxDevice,
            OnAttach.PortType,
            UsbfnActionNoCad);

        break;

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10
Piattaforma di destinazione	Windows
Intestazione	ufxclient.h
Libreria	ufxstub.lib
IRQL	DISPATCH_LEVEL

Condividi tramite