Funzione AcxFactoryCircuitInitAssignName (acxcircuit.h)

La funzione AcxFactoryCircuitInitAssignName assegna un nome descrittivo per ACXFACTORYCIRCUIT.

Sintassi

NTSTATUS AcxFactoryCircuitInitAssignName(
  PACXFACTORYCIRCUIT_INIT FactoryInit,
  PCUNICODE_STRING        FactoryName
);

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.

FactoryName

Stringa Unicode con il nome della factory del circuito, ad esempio Factory_Microphone.

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 di valori NTSTATUS.

Osservazioni

Esempio

Di seguito è riportato un esempio di utilizzo.

//
// Factory Name.
//
DECLARE_CONST_UNICODE_STRING(s_FactoryName, L"Render");
    
    //
    // Get a FactoryCircuitInit structure.
    //
    factoryInit = AcxFactoryCircuitInitAllocate(Device);

    //
    // Add factory identifiers.
    //
    AcxFactoryCircuitInitSetComponentId(factoryInit, &KSCATEGORY_APXCIRCUITFACTORY);
    AcxFactoryCircuitInitAssignCategories(factoryInit, &KSCATEGORY_APXCIRCUITFACTORY, 1);
    AcxFactoryCircuitInitAssignName(factoryInit, &s_FactoryName);

Requisiti ACX

versione minima di ACX: 1.0

Per altre informazioni sulle versioni di ACX, vedere panoramica della versione ACX.

Fabbisogno

Requisito	Valore
intestazione	acxcircuit.h
IRQL	PASSIVE_LEVEL

Vedere anche

• 'intestazione acxcircuit.h