función ACX_REQUEST_PARAMETERS_INIT_PROPERTY (acxrequest.h)
El ACX_REQUEST_PARAMETERS_INIT_PROPERTY inicializa una estructura de ACX_REQUEST_PARAMETERS con parámetros de propiedad ACX.
Sintaxis
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
);
Parámetros
Params
Puntero a ACX_REQUEST_PARAMETERS estructura que se usa para almacenar parámetros de propiedad.
Set
Un identificador de conjunto de propiedades (GUID).
Id
Identificador de propiedad (ULONG) dentro de la propiedad Set ID.
Verb
Verbo de propiedad ACX que se va a enviar tal y como se define en la enumeración ACX_PROPERTY_VERB .
ItemType
El ACX_ITEM_TYPE tipo de elemento que se envía, por ejemplo AcxItemTypeCircuit.
ItemId
Identificador de elemento del itemType, por ejemplo, el identificador de anclaje si ItemType es un pin.
Control
Un búfer de control opcional que contiene parámetros adicionales para la propiedad especificada. Se establece en NULL si no está presente.
ControlCb
Recuento en bytes (tamaño) del búfer de control. Se establece en 0 si no se usa el campo Control.
Value
Un búfer de valor opcional para especificar o recibir el valor de la propiedad. Se establece en NULL si no está presente o si *SendProperty debe asignarlo cuando ValueCb no es cero. El autor de la llamada es responsable de liberar el búfer asignado.
ValueCb
Recuento en bytes (tamaño) del búfer valor. Establezca en 0 si no se usa Value.
Valor devuelto
None
Notas
Ejemplo
A continuación se muestra un ejemplo de uso.
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);
...
Requisitos de ACX
Versión mínima de ACX: 1.0
Para obtener más información sobre las versiones de ACX, consulte Introducción a la versión de ACX.
Requisitos
| Requisito | Valor |
|---|---|
| Header | acxrequest.h |