Compartir a través de

Función AcxFactoryCircuitInitAssignName (acxcircuit.h)

  • Artículo

La función AcxFactoryCircuitInitAssignName asigna un nombre descriptivo para ACXFACTORYCIRCUIT.

Sintaxis

NTSTATUS AcxFactoryCircuitInitAssignName(
  PACXFACTORYCIRCUIT_INIT FactoryInit,
  PCUNICODE_STRING        FactoryName
);

Parámetros

FactoryInit

Estructura ACXFACTORYCIRCUIT_INIT que se usa para la inicialización del generador de circuitos. Se trata de una estructura opaca que se usa para almacenar la información de inicialización de fábrica del circuito ACX y asociar la fábrica a un dispositivo WDF.

Use la función AcxFactoryCircuitInitAllocate para inicializar la estructura de ACXFACTORYCIRCUIT_INIT.

FactoryName

Cadena unicode con el nombre del generador de circuitos, como Factory_Microphone.

Valor devuelto

Devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado. Para obtener más información, vea Uso de valores NTSTATUS.

Comentarios

Ejemplo

A continuación se muestra un ejemplo de uso.

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

Requisitos de ACX

Versión mínima de ACX: 1.0

Para obtener más información sobre las versiones de ACX, consulte Introducción a la versión de ACX.

Requisitos

Requisito Valor
Header acxcircuit.h
IRQL PASSIVE_LEVEL

Consulte también