AcxFactoryCircuitInitAssignName-Funktion (acxcircuit.h)

Wichtig

Einige Informationen beziehen sich auf ein Vorabrelease-Produkt, das vor der kommerziellen Veröffentlichung erheblich geändert werden kann. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Die AcxFactoryCircuitInitAssignName-Funktion weist dem ACXFACTORYCIRCUIT einen Anzeigenamen zu.

Syntax

NTSTATUS AcxFactoryCircuitInitAssignName(
  PACXFACTORYCIRCUIT_INIT FactoryInit,
  PCUNICODE_STRING        FactoryName
);

Parameter

FactoryInit

Eine ACXFACTORYCIRCUIT_INIT Struktur, die für die Initialisierung von Schaltkreisen verwendet wird. Dies ist eine undurchsichtige Struktur, die verwendet wird, um ACX Circuit-Initialisierungsinformationen zu speichern und die Fabrik einem WDF-Gerät zuzuordnen.

Verwenden Sie die AcxFactoryCircuitInitAllocate-Funktion , um die ACXFACTORYCIRCUIT_INIT Struktur zu initialisieren.

FactoryName

Eine Unicode-Zeichenfolge mit dem Namen der Schaltkreisfabrik, z. B. Factory_Microphone.

Rückgabewert

Gibt zurück STATUS_SUCCESS , wenn der Aufruf erfolgreich war. Andernfalls wird ein entsprechender Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.

Bemerkungen

Beispiel

Die Beispielverwendung wird unten gezeigt.

//
// 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);

Anforderungen

   
Header acxcircuit.h

Weitere Informationen