acxFactoryCircuitInitAssignName 函式 (acxcircuit.h)

AcxFactoryCircuitInitAssignName 函式會指派 ACXFACTORYCIRCUIT 的易記名稱。

語法

NTSTATUS AcxFactoryCircuitInitAssignName(
  PACXFACTORYCIRCUIT_INIT FactoryInit,
  PCUNICODE_STRING        FactoryName
);

參數

FactoryInit

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

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

FactoryName

具有線路處理站名稱的 unicode 字串，例如 Factory_Microphone。

傳回值

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

備註

範例

範例使用方式如下所示。

//
// Factory Name.
//
DECLARE_CONST_UNICODE_STRING(s_FactoryName, L"Render");
    
    //
    // Get a FactoryCircuitInit structure.
    //
    factoryInit = AcxFactoryCircuitInitAllocate(Device);

    //
    // Add factory identifiers.
    //
    AcxFactoryCircuitInitSetComponentId(factoryInit, &KSCATEGORY_APXCIRCUITFACTORY);
    AcxFactoryCircuitInitAssignCategories(factoryInit, &KSCATEGORY_APXCIRCUITFACTORY, 1);
    AcxFactoryCircuitInitAssignName(factoryInit, &s_FactoryName);

ACX 需求

最小 ACX 版本： 1.0

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

規格需求

需求	值
標頭	acxcircuit.h
IRQL	PASSIVE_LEVEL

另請參閱

• acxcircuit.h 標頭