ACX_REQUEST_PARAMETERS_INIT_METHOD 함수(acxrequest.h)

아티클
02/26/2024

ACX_REQUEST_PARAMETERS_INIT_METHOD 함수는 ACX 메서드 매개 변수를 사용하여 ACX_REQUEST_PARAMETERS 구조체를 초기화합니다.

구문

void ACX_REQUEST_PARAMETERS_INIT_METHOD(
  PACX_REQUEST_PARAMETERS Params,
  const GUID              Set,
  ULONG                   Id,
  ACX_METHOD_VERB         Verb,
  ACX_ITEM_TYPE           ItemType,
  ULONG                   ItemId,
  PVOID                   Args,
  ULONG                   ArgsCb,
  PVOID                   Result,
  ULONG                   ResultCb
);

매개 변수

Params

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

Set

GUID(메서드 Set ID)입니다.

Id

메서드 집합 ID 내의 메서드 ID(ULONG)입니다.

Verb

ACX_METHOD_VERB 열거형에서 정의한 대로 보낼 ACX 메서드 동사입니다.

ItemType

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

ItemId

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

Args

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

ArgsCb

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

Result

작업의 결과를 이전 버전으로 지정하는 선택적 결과 버퍼입니다. 없는 경우 null로 설정하거나 ResultCb가 0이 아닌 경우 *SendMethod가 할당해야 하는 경우 입니다. 호출자는 할당된 버퍼의 해제를 담당합니다.

ResultCb

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

반환 값

없음

설명

예제

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

            arg     = circuitArg;
            result  = 0;

            //
            // Format and send the request.
            //
            ACX_REQUEST_PARAMETERS_INIT_METHOD(
                &params,
                methodsTests[i].MethodSet,
                methodsTests[i].MethodId,
                AcxMethodVerbSend,
                AcxItemTypeCircuit,
                AcxItemIdNone,
                &arg, sizeof(arg),      // Args & size
                &result, sizeof(result) // Result & size
                );

ACX 요구 사항

최소 ACX 버전: 1.0

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

요구 사항

요구 사항	값
헤더	acxrequest.h

추가 정보

[acxrequest.h 헤더] (index.md)