ACX_REQUEST_PARAMETERS_INIT_PROPERTY 함수(acxrequest.h)

  • 아티클

ACX_REQUEST_PARAMETERS_INIT_PROPERTY ACX 속성 매개 변수를 사용하여 ACX_REQUEST_PARAMETERS 구조체를 초기화합니다.

구문

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

매개 변수

Params

속성 매개 변수를 저장하는 데 사용되는 ACX_REQUEST_PARAMETERS 구조체에 대한 포인터입니다.

Set

속성 GUID(Set ID)입니다.

Id

속성 집합 ID 내의 속성 ID(ULONG)입니다.

Verb

ACX_PROPERTY_VERB 열거형에서 정의한 대로 보낼 ACX 속성 동사입니다.

ItemType

보내는 항목의 ACX_ITEM_TYPE 유형입니다(예: AcxItemTypeCircuit).

ItemId

ItemType의 항목 ID(예: ItemType이 핀인 경우 핀 ID)입니다.

Control

지정된 속성에 대한 추가 매개 변수를 보유하는 선택적 Control 버퍼입니다. 없는 경우 null로 설정합니다.

ControlCb

컨트롤 버퍼의 바이트(크기)입니다. 컨트롤 필드가 사용되지 않는 경우 를 0으로 설정합니다.

Value

속성의 값을 지정하거나 받을 선택적 값 버퍼입니다. 없는 경우 null로 설정하거나 ValueCb가 0이 아닌 경우 *SendProperty에서 할당해야 하는 경우 입니다. 호출자는 할당된 버퍼의 해제를 담당합니다.

ValueCb

값 버퍼의 바이트(크기)입니다. 값을 사용하지 않으면 0으로 설정합니다.

반환 값

없음

설명

예제

예제 사용법은 다음과 같습니다.


    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 요구 사항

최소 ACX 버전: 1.0

ACX 버전에 대한 자세한 내용은 ACX 버전 개요를 참조하세요.

요구 사항

요구 사항 값
헤더 acxrequest.h

추가 정보