Partager via

fonction ACX_REQUEST_PARAMETERS_INIT_PROPERTY (acxrequest.h)

  • Article

Le ACX_REQUEST_PARAMETERS_INIT_PROPERTY initialise un struct ACX_REQUEST_PARAMETERS avec des 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

ID de jeu de propriétés (GUID).

Id

ID de propriété (ULONG) dans l’ID de jeu de propriétés.

Verb

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

ItemType

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

ItemId

ID d’élément de ItemType, par exemple l’ID d’épingle si 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éfini sur Null s’il n’est pas présent.

ControlCb

Nombre d’octets (taille) de la mémoire tampon de contrôle. Défini 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éfini sur Null s’il n’est pas présent ou si *SendProperty doit l’allouer lorsque ValueCb n’est pas zéro. L’appelant est chargé de libérer la mémoire tampon allouée.

ValueCb

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

Valeur de retour

Aucun

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 pour ACX

version minimale d’ACX : 1.0

Pour plus d’informations sur les versions ACX, consultez vue d’ensemble de la version ACX.

Exigences

Exigence Valeur
d’en-tête acxrequest.h

Voir aussi