acxFactoryCircuitInitAssignComponentUri 函式 (acxcircuit.h)

AcxFactoryCircuitInitAssignComponentUri 函式會將 URI 字串指派為 ACXFACTORYCIRCUIT 的標識符。

語法

NTSTATUS AcxFactoryCircuitInitAssignComponentUri(
  PACXFACTORYCIRCUIT_INIT FactoryInit,
  PCUNICODE_STRING        ComponentUri
);

參數

FactoryInit

用於線路處理站初始化的ACXFACTORYCIRCUIT_INIT結構。 這是不透明的結構，可用來儲存 ACX 線路處理站初始化資訊，並將處理站與 WDF 裝置產生關聯。

使用 AcxFactoryCircuitInitAllocate 函式 來初始化ACXFACTORYCIRCUIT_INIT結構。

ComponentUri

描述元件的 Unicode 字串。

傳回值

如果呼叫成功，則傳 STATUS_SUCCESS 回 。 否則，它會傳回適當的錯誤碼。 如需詳細資訊，請參閱 使用NTSTATUS值。

備註

驅動程式必須藉由設定線路處理站的 URI 和/或標識碼 (AcxCircuitInitSetComponentId) 來初始化線路處理站的身分識別。

範例

範例使用方式如下所示。

    DECLARE_CONST_UNICODE_STRING(dspFactoryName, L"DspFactoryCircuit");
    DECLARE_CONST_UNICODE_STRING(dspFactoryUri, L"URI_Goes_Here");

    //
    // Get a FactoryCircuitInit structure.
    //
    PACXFACTORYCIRCUIT_INIT factoryInit = NULL;
    factoryInit = AcxFactoryCircuitInitAllocate(Device);

    //
    // Add factory identifiers.
    //
    status = cxFactoryCircuitInitAssignComponentUri(factoryInit, &dspFactoryUri);
    status = AcxFactoryCircuitInitAssignName(factoryInit, &dspFactoryName);

ACX 需求

最小 ACX 版本： 1.0

如需 ACX 版本的詳細資訊，請參閱 ACX 版本概觀。

規格需求

需求	值
標頭	acxcircuit.h
IRQL	PASSIVE_LEVEL

另請參閱

• acxcircuit.h 標頭