acxFactoryCircuitInitAssignComponentUri 函式 (acxcircuit.h)
AcxFactoryCircuitInitAssignComponentUri 函式會將 URI 字串指派為 ACXFACTORYCIRCUIT 的標識符。
語法
NTSTATUS AcxFactoryCircuitInitAssignComponentUri(
PACXFACTORYCIRCUIT_INIT FactoryInit,
PCUNICODE_STRING ComponentUri
);
參數
FactoryInit
用於線路處理站初始化的ACXFACTORYCIRCUIT_INIT結構。 這是不透明的結構，可用來儲存 ACX 線路處理站初始化資訊，並將處理站與 WDF 裝置產生關聯。
使用 AcxFactoryCircuitInitAllocate 函式 來初始化ACXFACTORYCIRCUIT_INIT結構。
ComponentUri
描述元件的 Unicode 字串。
傳回值
如果呼叫成功，則傳 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 |