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(속성 집합 ID)입니다.
Id
속성 집합 ID 내의 속성 ID(ULONG)입니다.
Verb
ACX_PROPERTY_VERB 열거형에서 정의한 대로 보낼 ACX 속성 동사입니다.
ItemType
전송되는 항목의 ACX_ITEM_TYPE 유형(예: AcxItemTypeCircuit)입니다.
ItemId
ItemType의 항목 ID(예: ItemType이 핀인 경우 핀 ID)입니다.
Control
지정된 속성에 대한 추가 매개 변수를 보유하는 선택적 컨트롤 버퍼입니다. 없는 경우 null로 설정합니다.
ControlCb
Control 버퍼의 바이트(크기)입니다. 컨트롤 필드를 사용하지 않는 경우 0으로 설정합니다.
Value
속성 값을 지정하거나 받을 선택적 값 버퍼입니다. 없는 경우 또는 ValueCb가 0이 아닌 경우 *SendProperty에서 할당해야 하는 경우 null로 설정합니다. 호출자는 할당된 버퍼를 해제할 책임이 있습니다.
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 |