Partager via

fonction ACX_REQUEST_PARAMETERS_INIT_PROPERTY (acxrequest.h)

  • Article

Le ACX_REQUEST_PARAMETERS_INIT_PROPERTY initialise un struct de ACX_REQUEST_PARAMETERS avec les paramètres de propriété ACX.

Syntaxe

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

Paramètres

Params

Pointeur vers ACX_REQUEST_PARAMETERS structure utilisée pour stocker les paramètres de propriété.

Set

Propriété Set ID (GUID).

Id

ID de propriété (ULONG) dans la propriété Set ID.

Verb

Verbe de propriété ACX à envoyer tel que défini par l’énumération ACX_PROPERTY_VERB .

ItemType

Le ACX_ITEM_TYPE type d’élément envoyé, par exemple AcxItemTypeCircuit.

ItemId

ID d’élément de l’ÉlémentType, par exemple l’ID de broche si l’ItemType est une broche.

Control

Mémoire tampon de contrôle facultative contenant des paramètres supplémentaires pour la propriété spécifiée. Définissez sur null s’il n’est pas présent.

ControlCb

Nombre en octets (taille) de la mémoire tampon de contrôle. Définissez sur 0 si le champ Contrôle n’est pas utilisé.

Value

Mémoire tampon valeur facultative pour spécifier ou recevoir la valeur de la propriété. Définissez la valeur null si elle n’est pas présente ou si *SendProperty doit l’allouer lorsque ValueCb n’est pas égal à zéro. L’appelant est responsable de libérer la mémoire tampon allouée.

ValueCb

Nombre en octets (taille) de la mémoire tampon Value. Défini sur 0 si la valeur n’est pas utilisée.

Valeur de retour

None

Remarques

Exemple

L’exemple d’utilisation est illustré ci-dessous.


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

Configuration requise d’ACX

Version minimale d’ACX : 1.0

Pour plus d’informations sur les versions d’ACX, consultez Vue d’ensemble des versions d’ACX.

Configuration requise

Condition requise Valeur
En-tête acxrequest.h

Voir aussi