Función AcxFactoryCircuitInitAssignComponentUri (acxcircuit.h)
La función AcxFactoryCircuitInitAssignComponentUri asigna una cadena de URI como identificador para ACXFACTORYCIRCUIT.
Sintaxis
NTSTATUS AcxFactoryCircuitInitAssignComponentUri(
PACXFACTORYCIRCUIT_INIT FactoryInit,
PCUNICODE_STRING ComponentUri
);
Parámetros
FactoryInit
Estructura ACXFACTORYCIRCUIT_INIT que se usa para la inicialización de fábrica de circuitos. Se trata de una estructura opaca que se usa para almacenar la información de inicialización de fábrica del circuito ACX y asociar la fábrica a un dispositivo WDF.
Use el función AcxFactoryCircuitInitAllocate para inicializar la estructura de ACXFACTORYCIRCUIT_INIT.
ComponentUri
Cadena unicode que describe el componente.
Valor devuelto
Devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado. Para obtener más información, vea Using NTSTATUS Values.
Observaciones
El controlador debe inicializar la identidad del generador de circuitos estableciendo su URI o su identificador (AcxCircuitInitSetComponentId).
Ejemplo
A continuación se muestra el uso de ejemplo.
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);
Requisitos de ACX
versión mínima de ACX: 1.0
Para obtener más información sobre las versiones de ACX, consulte introducción a la versión de ACX.
Requisitos
| Requisito | Valor |
|---|---|
| encabezado de | acxcircuit.h |
| irQL | PASSIVE_LEVEL |