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 der Verbindungsfactory verwendet wird. Dies ist eine undurchsichtige Struktur, die verwendet wird, um AcX Circuit Factory-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 Verbindungsfactory, z. B. Factory_Microphone.
Rückgabewert
Gibt zurück STATUS_SUCCESS , wenn der Aufruf erfolgreich war. Andernfalls wird ein geeigneter Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.
Bemerkungen
Beispiel
Das Beispiel für die Verwendung ist unten dargestellt.
//
// 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
ACX-Mindestversion: 1.0
Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |