PFNAVCINTERSECTHANDLER 콜백 함수(avc.h)

  • 아티클

AV/C 교차 처리기는 데이터 범위가 호환되는지 여부를 결정합니다. 다음 프로토타입을 기반으로 하는 사용자 정의 함수입니다.

구문

typedef NTSTATUS ( *PFNAVCINTERSECTHANDLER)(
  _In_      PVOID        Context,
  _In_      ULONG        PinId,
  _In_      PKSDATARANGE CallerDataRange,
  _In_      PKSDATARANGE DescriptorDataRange,
  _In_      ULONG        DataBufferSize,
  _Out_opt_ PVOID        Data,
  _Out_     PULONG       ReportedDataSize
);

매개 변수

[in] Context

교차 처리기에 필요한 선택적 값입니다. 이 값은 하위 단위 드라이버(하위 단위 드라이버가 교차 처리기를 제공하는 경우) 또는 교차 처리기를 제공하는 하위 드라이버에서 제공합니다.

[in] PinId

교차가 수행되는 핀의 오프셋(또는 ID)을 지정합니다.

[in] DataRange

[in] MatchingDataRange

[in] DataBufferSize

데이터 멤버가 전달한 버퍼의 크기입니다. 0이 아닌 경우 교차 처리기는 일치하는 데이터 범위 쌍에서 생성된 데이터 형식을 반환하려고 시도해야 합니다. 이 값이 0이면 교차 처리기는 ReportedDataSize에 필요한 버퍼 크기를 제공하고 STATUS_BUFFER_OVERFLOW 반환해야 합니다.

[out, optional] Data

일치하는 데이터 범위 쌍으로 인해 발생하는 데이터 형식을 수신하는 선택적 버퍼입니다. DataBufferSize가 0이면 이 멤버는 무시됩니다.

[out] DataSize

반환 값

교차 처리기는 데이터 범위가 호환되고 결과 형식을 반환하기에 충분한 버퍼 공간이 있는 경우 STATUS_SUCCESS 반환해야 합니다.

반환 코드 설명
STATUS_NO_MATCH 데이터 범위는 호환되지 않습니다.
STATUS_INTERNAL_ERROR 예기치 않은 형식 크기 불일치가 있었습니다.
STATUS_BUFFER_OVERFLOW 교차 처리기는 ReportedDataSize 멤버를 통해 필요한 버퍼 크기를 반환합니다.
STATUS_BUFFER_TOO_SMALL 교차 처리기에 결과 형식을 보유할 수 있을 만큼 큰 버퍼가 제공되지 않았습니다. 필요한 버퍼 크기를 확인하려면 DataBufferSize 를 0으로 설정하여 교차 처리기를 다시 호출해야 합니다.
STATUS_INSUFFICIENT_RESOURCES 내부 버퍼 할당에 실패했습니다.

설명

AV/C 교차 처리기는 위의 함수 프로토타입에 따라 사용자 정의입니다.

처리기는 AVC_FUNCTION_GET_PIN_DESCRIPTOR 함수 코드와 함께 사용됩니다. 처리기의 목적은 동일한 핀 데이터 형식을 일치시키고 호출자에게 반환하는 것입니다.

요구 사항

요구 사항 값
대상 플랫폼 데스크톱
머리글 avc.h(Avc.h 포함)

추가 정보