AcxFactoryCircuitInitAssignName-Funktion (acxcircuit.h)
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 des Schaltkreises verwendet wird. Dies ist eine undurchsichtige Struktur, die verwendet wird, um ACX Circuit-Initialisierungsinformationen zu speichern und die Factory 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 Schaltkreisfactory, z. B. Factory_Microphone.
Rückgabewert
Gibt STATUS_SUCCESS zurück, wenn der Anruf 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);
ACX-Anforderungen
Mindestens ACX-Version: 1.0
Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | acxcircuit.h |
| IRQL- | PASSIVE_LEVEL |