Функция AcxCircuitInitAssignComponentUri (acxcircuit.h)
Функция AcxCircuitInitAssignComponentUri назначает строку URI в качестве идентификатора для ACXCIRCUIT.
Синтаксис
NTSTATUS AcxCircuitInitAssignComponentUri(
PACXCIRCUIT_INIT CircuitInit,
PCUNICODE_STRING ComponentUri
);
Параметры
CircuitInit
Структура ACXCIRCUIT_INIT, которая определяет инициализацию канала. ACXCIRCUIT_INIT — это непрозрачный объект, используемый для инициализации канала. Используйте AcxCircuitInitAllocate для инициализации структуры ACXCIRCUIT_INIT.
ComponentUri
Строка Юникода, описывающая универсальный код ресурса (URI), который однозначно идентифицирует ACXCIRCUIT.
Возвращаемое значение
Возвращает значение STATUS_SUCCESS , если вызов был выполнен успешно. В противном случае возвращается соответствующий код ошибки. Дополнительные сведения см. в разделе Использование значений NTSTATUS.
Комментарии
Драйвер должен инициализировать удостоверение канала, задав его URI и (или) идентификатор (AcxCircuitInitSetComponentId).
Пример
Ниже приведен пример использования.
DECLARE_CONST_UNICODE_STRING(CODEC_CIRCUIT_CAPTURE_URI, L"acx:test:acxcodectestdriver:codec0:circuit0:microphone0");
// Get a CircuitInit structure.
//
circuitInit = AcxCircuitInitAllocate(Device);
//
// Add circuit identifiers.
//
status = AcxCircuitInitAssignComponentUri(circuitInit, &CODEC_CIRCUIT_CAPTURE_URI);
Требования к ACX
Минимальная версия ACX: 1.0
Дополнительные сведения о версиях ACX см. в статье Обзор версий ACX.
Требования
| Требование | Значение |
|---|---|
| Заголовок | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |