KsPinDataIntersection 함수(ks.h)

KsPinDataIntersection 함수는 콜백 함수를 통해 KSPROPERTY_PIN_DATAINTERSECTION 속성을 처리하고 전달된 매개 변수의 초기 유효성 검사를 대부분 수행합니다. KsPinDataIntersection 은 해당 핀 팩터리에 할당된 데이터 범위 목록과 일치한 후 각 잠재적 데이터 범위와 미니드라이버 정의 KStrIntersectHandler 콜백 함수를 호출합니다.

구문

KSDDKAPI NTSTATUS KsPinDataIntersection(
  [in]            PIRP                   Irp,
  [in]            PKSP_PIN               Pin,
  [out, optional] PVOID                  Data,
  [in]            ULONG                  DescriptorsCount,
  [in]            const KSPIN_DESCRIPTOR *Descriptor,
  [in]            PFNKSINTERSECTHANDLER  IntersectHandler
);

매개 변수

[in] Irp

속성 요청을 설명하는 IRP를 지정합니다.

[in] Pin

쿼리할 특정 속성을 지정합니다.

[out, optional] Data

pin 속성별 데이터를 지정합니다.

[in] DescriptorsCount

설명자 구조체의 수를 지정합니다.

[in] Descriptor

핀 정보 구조 목록에 대한 포인터를 지정합니다.

[in] IntersectHandler

데이터 범위를 비교할 미니드라이버 정의 KStrIntersectHandler 콜백 함수를 지정합니다.

반환 값

KsPinDataIntersection 함수는 일치하는 범위가 발견되면 STATUS_SUCCESS 반환하고, 일치하는 범위를 찾지 STATUS_NO_MATCH, 처리 중인 속성과 관련된 오류를 반환합니다. KsPinDataIntersection에 제공된 미니드라이버 정의 KStrIntersectHandler 교차 처리기는 일치 항목이 발견되거나 오류가 발생할 때까지 호출자가 제공하는 각 데이터 범위로 호출됩니다.

미니드라이버 정의 KStrIntersectHandler 콜백 함수에는 고유한 반환 값 집합이 있습니다.

설명

전달된 범위의 주요 형식이 와일드카드이거나 핀 팩터리 범위와 일치하는 경우, 하위 폼이 와일드카드 또는 일치하는 경우, 지정자가 와일드카드 또는 일치인 경우의 세 가지 조건에서 일치가 발생할 수 있습니다. 데이터 범위 크기는 가변적일 수 있으므로 적어도 KSDATARANGE 구조체의 크기인지 확인하는 것 외에는 유효성이 검사되지 않습니다.

요구 사항

요구 사항	값
대상 플랫폼	유니버설
헤더	ks.h(Ks.h 포함)
라이브러리	Ks.lib

추가 정보

KSDATARANGE

KStrIntersectHandler