UcxRootHubCreate 函式 (ucxroothub.h)

為指定的主控制器建立根中樞物件。

語法

NTSTATUS UcxRootHubCreate(
  [in]           UCXCONTROLLER          Controller,
  [in]           PUCX_ROOTHUB_CONFIG    Config,
  [in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
  [out]          UCXROOTHUB             *RootHub
);

參數

[in] Controller

控制器物件的句柄。 用戶端驅動程式在先前呼叫 UcxControllerCreate 中擷取句柄。

[in] Config

UCX_ROOTHUB_CONFIG 結構的指標，描述建立根中樞對象的各種組態作業。

[in, optional] Attributes

呼叫端配置的 WDF_OBJECT_ATTRIBUTES 結構的指標，指定根中樞對象的屬性。

[out] RootHub

接收新根中樞物件句柄之變數的指標。

傳回值

如果作業成功，方法會傳回STATUS_SUCCESS。 否則，這個方法可能會傳回一個適當的 NTSTATUS 錯誤碼。

備註

主機控制器的用戶端驅動程序必須在 WdfDeviceCreate 呼叫之後呼叫這個方法。 新根中樞物件的父系是控制器物件。

呼叫這個方法之前，用戶端驅動程序必須先呼叫UCX_ROOTHUB_CONFIG_INIT來初始化UCX_ROOTHUB_CONFIG結構。 藉由呼叫設定適當的 UCX_ROOTHUB_CONFIG成員，為驅動程式提供的事件回呼實作提供函式指標。 當根中樞對象發生事件時，UCX 會叫用這些回呼函式。

範例

    UCX_ROOTHUB_CONFIG                      ucxRootHubConfig;
    UCXROOTHUB                              ucxRootHub;
    PUCX_ROOTHUB_CONTEXT                    ucxRootHubContext;
  

    // Create the root hub
    //
    UCX_ROOTHUB_CONFIG_INIT(&ucxRootHubConfig,
                            RootHub_EvtRootHubClearHubFeature,
                            RootHub_EvtRootHubClearPortFeature,
                            RootHub_EvtRootHubGetHubStatus,
                            RootHub_EvtRootHubGetPortStatus,
                            RootHub_EvtRootHubSetHubFeature,
                            RootHub_EvtRootHubSetPortFeature,
                            RootHub_EvtRootHubGetPortErrorCount,
                            RootHub_EvtRootHubInterruptTx,
                            RootHub_EvtRootHubGetInfo,
                            RootHub_EvtRootHubGet20PortInfo,
                            RootHub_EvtRootHubGet30PortInfo);

    WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&objectAttributes, UCX_ROOTHUB_CONTEXT);

    status = UcxRootHubCreate(ucxController,
                              &ucxRootHubConfig,
                              &objectAttributes,
                              &ucxRootHub);

    if (!NT_SUCCESS(status)) {
        DbgTrace(TL_ERROR, Controller, "UcxRootHubCreate Failed %!STATUS!", status);
        goto Controller_WdfEvtDeviceAddEnd;
    }

    DbgTrace(TL_INFO, Controller, "UCX Root Hub created.");

    ucxControllerContext->UcxRootHub = ucxRootHub;

    ucxRootHubContext = GetUcxRootHubContext(ucxRootHub);
    ucxRootHubContext->UcxController = ucxController;

規格需求

需求	值
最低支援的用戶端	Windows 10
標頭	ucxroothub.h
IRQL	PASSIVE_LEVEL

另請參閱

UCX_ROOTHUB_CONFIG