Функция 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

См. также раздел

• Заголовок acxcircuit.h