Поделиться через

Функция AcxFactoryCircuitInitAssignComponentUri (acxcircuit.h)

Функция AcxFactoryCircuitInitAssignComponentUri назначает строку URI в качестве идентификатора ACXFACTORYCIRCUIT.

Синтаксис

NTSTATUS AcxFactoryCircuitInitAssignComponentUri(
  PACXFACTORYCIRCUIT_INIT FactoryInit,
  PCUNICODE_STRING        ComponentUri
);

Параметры

FactoryInit

Структура ACXFACTORYCIRCUIT_INIT, используемая для инициализации фабрики каналов. Это непрозрачная структура, которая используется для хранения сведений о инициализации фабрики каналов ACX и связывания фабрики с устройством WDF.

Используйте функцию AcxFactoryCircuitInitAllocate для инициализации структуры ACXFACTORYCIRCUIT_INIT.

ComponentUri

Строка юникода, описывающая компонент.

Возвращаемое значение

Возвращает 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

См. также