Freigeben über

AcxFactoryCircuitInitAssignComponentUri-Funktion (acxcircuit.h)

  • Artikel

Die AcxFactoryCircuitInitAssignComponentUri-Funktion weist eine URI-Zeichenfolge als Bezeichner für ACXFACTORYCIRCUIT zu.

Syntax

NTSTATUS AcxFactoryCircuitInitAssignComponentUri(
  PACXFACTORYCIRCUIT_INIT FactoryInit,
  PCUNICODE_STRING        ComponentUri
);

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.

ComponentUri

Eine Unicode-Zeichenfolge, die die Komponente beschreibt.

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.

Hinweise

Der Treiber muss die Identität der Verbindungsfactory initialisieren, indem er seinen URI und/oder seine ID (AcxCircuitInitSetComponentId) festlegt.

Beispiel

Das Beispiel für die Verwendung ist unten dargestellt.

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

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

Weitere Informationen