ACX_REQUEST_PARAMETERS_INIT_METHOD-Funktion (acxrequest.h)

Artikel
02/22/2024

Die ACX_REQUEST_PARAMETERS_INIT_METHOD-Funktion initialisiert eine ACX_REQUEST_PARAMETERS Struktur mit ACX-Methodenparametern.

Syntax

void ACX_REQUEST_PARAMETERS_INIT_METHOD(
  PACX_REQUEST_PARAMETERS Params,
  const GUID              Set,
  ULONG                   Id,
  ACX_METHOD_VERB         Verb,
  ACX_ITEM_TYPE           ItemType,
  ULONG                   ItemId,
  PVOID                   Args,
  ULONG                   ArgsCb,
  PVOID                   Result,
  ULONG                   ResultCb
);

Parameter

Params

Ein Zeiger auf ACX_REQUEST_PARAMETERS Struktur, die zum Speichern von Methodenparametern verwendet wird.

Set

Eine Methode Set-ID (GUID).

Id

Eine Methoden-ID (ULONG) innerhalb der Set-ID der Methode.

Verb

Das zu sendende ACX-Methodenverb, wie durch die ACX_METHOD_VERB-Enumeration definiert.

ItemType

Der ACX_ITEM_TYPE Typ des gesendeten Elements, z. B. AcxItemTypeCircuit.

ItemId

Die Element-ID des ItemType, z. B. die Pin-ID, wenn der ItemType eine Anheftung ist.

Args

Ein optionaler Args-Puffer mit zusätzlichen Parametern für die angegebene Methode. Legen Sie auf NULL fest, wenn sie nicht vorhanden ist.

ArgsCb

Die Anzahl in Bytes (Größe) des Args-Puffers. Legen Sie auf 0 fest, wenn das Args-Feld nicht verwendet wird.

Result

Ein optionaler Ergebnispuffer, um das Ergebnis des Vorgangs zu alt zu machen. Legen Sie auf NULL fest, wenn sie nicht vorhanden ist oder wenn *SendMethod sie zuordnen muss, wenn ResultCb nicht 0 ist. Der Aufrufer ist für das Freigeben des zugewiesenen Puffers verantwortlich.

ResultCb

Die Anzahl in Bytes (Größe) des Ergebnispuffers. Legen Sie auf 0 fest, wenn Result nicht verwendet wird.

Rückgabewert

Keine

Bemerkungen

Beispiel

Die Verwendungsbeispiele finden Sie unten.

            arg     = circuitArg;
            result  = 0;

            //
            // Format and send the request.
            //
            ACX_REQUEST_PARAMETERS_INIT_METHOD(
                &params,
                methodsTests[i].MethodSet,
                methodsTests[i].MethodId,
                AcxMethodVerbSend,
                AcxItemTypeCircuit,
                AcxItemIdNone,
                &arg, sizeof(arg),      // Args & size
                &result, sizeof(result) // Result & size
                );

ACX-Anforderungen

AcX-Mindestversion: 1.0

Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.

Anforderungen

Anforderung	Wert
Header	acxrequest.h

Weitere Informationen

[acxrequest.h header] (index.md)

Freigeben über