Compartir a través de

Función AcxFactoryCircuitInitAssignComponentUri (acxcircuit.h)

  • Artículo

La función AcxFactoryCircuitInitAssignComponentUri asigna una cadena URI como identificador para ACXFACTORYCIRCUIT.

Sintaxis

NTSTATUS AcxFactoryCircuitInitAssignComponentUri(
  PACXFACTORYCIRCUIT_INIT FactoryInit,
  PCUNICODE_STRING        ComponentUri
);

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.

ComponentUri

Cadena unicode que describe el componente.

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

El controlador debe inicializar la identidad del generador de circuitos estableciendo su URI o su identificador (AcxCircuitInitSetComponentId).

Ejemplo

A continuación se muestra un ejemplo de uso.

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

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