UfxDevicePortDetectCompleteEx 関数 (ufxclient.h)

検出されたポートの種類について UFX に通知し、必要に応じてアクションを要求します。

構文

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

パラメーター

[in] UfxDevice

ドライバーが UfxDeviceCreate を呼び出して作成した UFX デバイス オブジェクトへのハンドル。

[in] PortType

USBFN_PORT_TYPE型の列挙値を格納します。

[in] Action

USBFN_ACTION型の列挙値を格納します。

戻り値

なし

解説

クライアント ドライバーは、ポート検出が完了した後、通常はEVT_UFX_DEVICE_PORT_DETECTコールバック関数から UfxDevicePortDetectCompleteEx を呼び出します。 一部のプラットフォームでは、UFX は報告されたポートの種類を使用して、USB ポートから引き出すことができる最大電流をバッテリー マネージャーに通知することがあります。

Action パラメーターが UsbfnActionNoCad に設定されている場合、UFX はバッテリ マネージャーにまったく通知しません。

Action パラメーターが UsbfnActionDetectProprietaryCharger に設定されている場合、UFX は、クライアント ドライバーの EVT_UFX_DEVICE_DETECT_PROPRIETARY_CHARGER コールバック関数を呼び出すことによって、クライアント ドライバーが独自の充電器検出を開始するように要求します。

次のスニペットは、クライアント ドライバーが 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;

要件

要件	値
サポートされている最小のクライアント	Windows 10
対象プラットフォーム	Windows
ヘッダー	ufxclient.h
Library	ufxstub.lib
IRQL	DISPATCH_LEVEL