Funzione AcxFactoryCircuitInitAssignComponentUri (acxcircuit.h)
La funzione AcxFactoryCircuitInitAssignComponentUri assegna una stringa URI come identificatore per ACXFACTORYCIRCUIT.
Sintassi
NTSTATUS AcxFactoryCircuitInitAssignComponentUri(
PACXFACTORYCIRCUIT_INIT FactoryInit,
PCUNICODE_STRING ComponentUri
);
Parametri
FactoryInit
Struttura ACXFACTORYCIRCUIT_INIT utilizzata per l'inizializzazione della factory del circuito. Si tratta di una struttura opaca usata per archiviare le informazioni di inizializzazione della factory del circuito ACX e associare la factory a un dispositivo WDF.
Utilizzare la funzione AcxFactoryCircuitInitAllocate per inizializzare la struttura ACXFACTORYCIRCUIT_INIT.
ComponentUri
Stringa Unicode che descrive il componente.
Valore restituito
Restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato. Per altre informazioni, vedere Uso dei valori NTSTATUS.
Commenti
Il driver deve inizializzare l'identità della factory del circuito impostandone l'URI e/o il relativo ID (AcxCircuitInitSetComponentId).
Esempio
Di seguito è riportato un esempio di utilizzo.
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);
Requisiti di ACX
Versione minima di ACX: 1.0
Per altre informazioni sulle versioni ACX, vedere La panoramica della versione di ACX.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |