EVT_UCX_USBDEVICE_HUB_INFO回呼函式 (ucxusbdevice.h)

發行項
02/26/2024

UCX 呼叫以擷取中樞屬性的用戶端驅動程序實作。

語法

EVT_UCX_USBDEVICE_HUB_INFO EvtUcxUsbdeviceHubInfo;

void EvtUcxUsbdeviceHubInfo(
  [in] UCXCONTROLLER UcxController,
  [in] WDFREQUEST Request
)
{...}

參數

[in] UcxController

用戶端驅動程式在先前呼叫 UcxControllerCreate 方法時收到的UCX控制器句柄。

[in] Request

包含 USBDEVICE_HUB_INFO 結構。

傳回值

無

備註

UCX 用戶端驅動程式會呼叫 UcxUsbDeviceCreate 方法，向 USB 主機控制器擴充功能註冊此回呼函式， (UCX) 。

如果USB裝置不是中樞，請勿提供此回呼。

用戶端驅動程式會在 [要求] 中傳回完成狀態。驅動程式可以異步完成 WDFREQUEST。

範例

VOID
UsbDevice_EvtUcxUsbDeviceHubInfo(
    UCXCONTROLLER      UcxController,
    WDFREQUEST         Request
)

{
    UNREFERENCED_PARAMETER(UcxController);

    DbgTrace(TL_INFO, UsbDevice, "UsbDevice_EvtUcxUsbDeviceHubInfo");

    //
    // Retrieve the USBDEVICE_HUB_INFO pointer from the
    // IOCTL_INTERNAL_USB_USBDEVICE_HUB_INFO WdfRequest.
    //
    WDF_REQUEST_PARAMETERS_INIT(&wdfRequestParams);
    WdfRequestGetParameters(WdfRequest, &wdfRequestParams);

    hubInfo = (PUSBDEVICE_HUB_INFO)wdfRequestParams.Parameters.Others.Arg1;

    ....


    WdfRequestComplete(Request, STATUS_SUCCESS);
}