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 vom Treiber erstellt wurde, indem UfxDeviceCreateaufgerufen wird.

[in] PortType

Enthält einen Enumerationswert vom Typ USBFN_PORT_TYPE.

[in] Action

Enthält einen Enumerationswert vom Typ USBFN_ACTION.

Rückgabewert

Nichts

Bemerkungen

Der Clienttreiber ruft UfxDevicePortDetectCompleteEx- nach Abschluss der Porterkennung auf, in der Regel von der EVT_UFX_DEVICE_PORT_DETECT Rückruffunktion. Auf einigen Plattformen kann UFX den gemeldeten Porttyp verwenden, um den Akku-Manager über den maximalen Strom zu informieren, den er vom USB-Anschluss ziehen kann.

Wenn der parameter Action auf UsbfnActionNoCadfestgelegt ist, benachrichtigt UFX den Akku-Manager überhaupt nicht.

Wenn der parameter Action auf UsbfnActionDetectProprietaryChargerfestgelegt ist, fordert UFX an, dass der Clienttreiber die proprietäre Ladegeräterkennung 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