UfxDevicePortDetectCompleteEx-Funktion (ufxclient.h)

Benachrichtigt UFX über den erkannten Porttyp und fordert optional eine Aktion an.

Syntax

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

Parameter

[in] UfxDevice

Ein Handle für ein UFX-Geräteobjekt, das der Treiber durch Aufrufen von UfxDeviceCreate erstellt hat.

[in] PortType

Enthält einen Enumerationswert vom Typ USBFN_PORT_TYPE.

[in] Action

Enthält einen Enumerationswert vom Typ USBFN_ACTION.

Rückgabewert

Keine

Bemerkungen

Der Clienttreiber ruft UfxDevicePortDetectCompleteEx auf, nachdem die Porterkennung abgeschlossen ist, in der Regel über seine EVT_UFX_DEVICE_PORT_DETECT Rückruffunktion. Auf einigen Plattformen kann UFX den gemeldeten Porttyp verwenden, um den Batteriemanager über den maximalen Strom zu informieren, den er vom USB-Anschluss ziehen kann.

Wenn der Aktionsparameter auf UsbfnActionNoCad festgelegt ist, benachrichtigt UFX den Akku-Manager überhaupt nicht.

Wenn der Action-Parameter auf UsbfnActionDetectProprietaryCharger festgelegt ist, fordert UFX an, dass der Clienttreiber die Erkennung proprietärer Ladegeräte initiiert, indem die EVT_UFX_DEVICE_DETECT_PROPRIETARY_CHARGER Rückruffunktion des Clienttreibers aufgerufen wird.

Der folgende Codeausschnitt zeigt, wie ein Clienttreiber UfxDevicePortDetectCompleteEx aufruft.

    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;

Anforderungen