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 |