ACX_REQUEST_PARAMETERS_INIT_PROPERTY-Funktion (acxrequest.h)

  • Artikel

Die ACX_REQUEST_PARAMETERS_INIT_PROPERTY initialisiert eine ACX_REQUEST_PARAMETERS Struktur mit ACX-Eigenschaftsparametern.

Syntax

void ACX_REQUEST_PARAMETERS_INIT_PROPERTY(
  PACX_REQUEST_PARAMETERS Params,
  const GUID              Set,
  ULONG                   Id,
  ACX_PROPERTY_VERB       Verb,
  ACX_ITEM_TYPE           ItemType,
  ULONG                   ItemId,
  PVOID                   Control,
  ULONG                   ControlCb,
  PVOID                   Value,
  ULONG                   ValueCb
);

Parameter

Params

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

Set

Eine Eigenschaft Set ID (GUID).

Id

Eine Eigenschafts-ID (ULONG) innerhalb der Eigenschaft Set ID.

Verb

Das zu sendende ACX-Eigenschaftsverb, wie durch die ACX_PROPERTY_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 Pin ist.

Control

Ein optionaler Control-Puffer mit zusätzlichen Parametern für die angegebene Eigenschaft. Wird auf NULL festgelegt, wenn nicht vorhanden.

ControlCb

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

Value

Ein optionaler Wertpuffer zum Angeben oder Empfangen des Werts der Eigenschaft. Legen Sie auf NULL fest, wenn nicht vorhanden ist, oder wenn *SendProperty sie zuordnen muss, wenn ValueCb nicht null ist. Der Aufrufer ist für das Freigeben des zugeordneten Puffers verantwortlich.

ValueCb

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

Rückgabewert

Keine

Bemerkungen

Beispiel

Das Beispiel für die Verwendung ist unten dargestellt.


    NTSTATUS                    status = STATUS_SUCCESS;
    PKSPIN_PHYSICALCONNECTION   physicalConnection = nullptr;
    PAUDIO_PATH_DESCRIPTOR      descriptor = nullptr;

    // For the Audio Circuit, send a request to each Target Pin asking KSPROPERTY_PIN_PHYSICALCONNECTION
    // This will give us symbolic link of the next circuit in the Audio Path (if there is any)

    for (ULONG i = 0; i < ARRAYSIZE(AudioCircuit->Pins) && AudioCircuit->Pins[i].TargetPin; ++i)
    {
        ACX_REQUEST_PARAMETERS requestParams{ 0 };

        ACX_REQUEST_PARAMETERS_INIT_PROPERTY(
            &requestParams,
            KSPROPSETID_Pin,
            KSPROPERTY_PIN_PHYSICALCONNECTION,
            AcxPropertyVerbGet,
            AcxItemTypePin,
            i,
            nullptr,
            0,
            // null Value so SendProperty will allocate it for us. We'll need to free it.
            nullptr,
            0);
...

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