Функция AcxFactoryCircuitInitAssignName (acxcircuit.h)
Функция AcxFactoryCircuitInitAssignName присваивает понятное имя для ACXFACTORYCIRCUIT.
Синтаксис
NTSTATUS AcxFactoryCircuitInitAssignName(
PACXFACTORYCIRCUIT_INIT FactoryInit,
PCUNICODE_STRING FactoryName
);
Параметры
FactoryInit
Структура ACXFACTORYCIRCUIT_INIT, используемая для инициализации фабрики цепи. Это непрозрачная структура, которая используется для хранения сведений об инициализации фабрики цепи ACX и связывания фабрики с устройством WDF.
Используйте функцию AcxFactoryCircuitInitAllocate для инициализации структуры ACXFACTORYCIRCUIT_INIT.
FactoryName
Строка Юникода с именем фабрики цепи, например Factory_Microphone.
Возвращаемое значение
Возвращает значение STATUS_SUCCESS , если вызов был выполнен успешно. В противном случае возвращается соответствующий код ошибки. Дополнительные сведения см. в разделе Использование значений NTSTATUS.
Remarks
Пример
Ниже приведен пример использования.
//
// 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);
Требования к ACX
Минимальная версия ACX: 1.0
Дополнительные сведения о версиях ACX см. в статье Обзор версий ACX.
Требования
| Требование | Значение |
|---|---|
| Заголовок | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |