acxCircuitInitAssignName 函式 (acxcircuit.h)
AcxCircuitInitAssignName 函式會指派 ACXCIRCUIT 的易記名稱。
語法
NTSTATUS AcxCircuitInitAssignName(
PACXCIRCUIT_INIT CircuitInit,
PCUNICODE_STRING CircuitName
);
參數
CircuitInit
定義線路初始化的ACXCIRCUIT_INIT結構。 ACXCIRCUIT_INIT是用於線路初始化的不透明物件。 使用 AcxCircuitInitAllocate 初始化ACXCIRCUIT_INIT結構。
CircuitName
具有線路名稱的 Unicode 字串,例如 Microphone0。
傳回值
如果呼叫成功,則傳 STATUS_SUCCESS
回 。 否則,它會傳回適當的錯誤碼。 如需詳細資訊,請參閱 使用NTSTATUS值。
備註
CircuitName 字串必須符合識別音訊介面的 INF 字串。
範例
範例使用方式如下所示。
// Circuit Name
DECLARE_CONST_UNICODE_STRING(circuitName, L"Microphone0");
//
// Add circuit identifiers.
//
AcxCircuitInitSetComponentId(CircuitInit, &COMPONENT_GUID);
AcxCircuitInitAssignName(CircuitInit, &circuitName);
ACX 需求
最小 ACX 版本: 1.0
如需 ACX 版本的詳細資訊,請參閱 ACX 版本概觀。
規格需求
需求 | 值 |
---|---|
標頭 | acxcircuit.h |
IRQL | PASSIVE_LEVEL |