acxFactoryCircuitInitAssignName 函式 (acxcircuit.h)

重要

某些資訊與發行前版本產品有關,在正式發行前可能會大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。

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);

規格需求

   
標頭 acxcircuit.h

另請參閱