Condividi tramite

funzione ACX_REQUEST_PARAMETERS_INIT_PROPERTY (acxrequest.h)

  • Articolo

L'ACX_REQUEST_PARAMETERS_INIT_PROPERTY inizializza uno struct ACX_REQUEST_PARAMETERS con i parametri delle proprietà ACX.

Sintassi

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

Parametri

Params

Puntatore alla struttura ACX_REQUEST_PARAMETERS utilizzata per archiviare i parametri delle proprietà.

Set

ID set di proprietà (GUID).

Id

ID proprietà (ULONG) all'interno della proprietà Set ID.

Verb

Verbo della proprietà ACX da inviare come definito dall'enumerazione ACX_PROPERTY_VERB .

ItemType

Tipo di elemento inviato ACX_ITEM_TYPE, ad esempio AcxItemTypeCircuit.

ItemId

ID elemento di ItemType, ad esempio l'ID pin se ItemType è un pin.

Control

Buffer di controllo facoltativo che contiene parametri aggiuntivi per la proprietà specificata. Impostare su Null se non presente.

ControlCb

Conteggio in byte (dimensioni) del buffer di controllo. Impostare su 0 se il campo Controllo non viene usato.

Value

Buffer valore facoltativo per specificare o ricevere il valore della proprietà. Impostare su Null se non presente o se *SendProperty deve allocarlo quando ValueCb non è zero. Il chiamante è responsabile della liberazione del buffer allocato.

ValueCb

Conteggio in byte (dimensioni) del buffer Valore. Impostare su 0 se Valore non viene usato.

Valore restituito

nessuno

Osservazioni

Esempio

Di seguito è riportato l'esempio di utilizzo.


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

Requisiti ACX

Versione minima DI ACX: 1.0

Per altre informazioni sulle versioni ACX, vedere Panoramica della versione di ACX.

Requisiti

Requisito Valore
Intestazione acxrequest.h

Vedi anche