KsValidateConnectRequest 함수(ks.h)

KsValidateConnectRequest 함수는 연결 요청의 유효성을 검사하고 요청과 연결된 연결 구조에 대한 포인터를 반환합니다.

이 함수는 PASSIVE_LEVEL 호출할 수 있습니다.

구문

KSDDKAPI NTSTATUS KsValidateConnectRequest(
  [in]  PIRP                   Irp,
  [in]  ULONG                  DescriptorsCount,
  [in]  const KSPIN_DESCRIPTOR *Descriptor,
  [out] PKSPIN_CONNECT         *Connect
);

매개 변수

[in] Irp

연결 요청을 지정하는 IRP에 대한 포인터입니다.

[in] DescriptorsCount

전달된 핀 설명자 수를 지정합니다.

[in] Descriptor

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

[out] Connect

만들기 요청에 전달된 KSPIN_CONNECT 포인터에 포인터를 배치할 위치를 지정합니다. KsValidateConnectRequest가 성공을 반환하는 경우 Connect+1에는 핀이 열린 KSDATAFORMAT에 대한 포인터가 포함됩니다.

반환 값

KsValidateConnectRequest 함수는 성공하면 STATUS_SUCCESS 반환하거나 오류를 반환합니다.

설명

KsValidateConnectRequest 함수는 기본 연결 구조 액세스 예외를 처리하고 통신 요구 사항, 중간, 프로토콜 및 기본 데이터 형식의 유효성을 검사합니다. 전달된 데이터 형식에서 수행되는 유효성 검사는 핀 instance 만들 지정된 핀의 데이터 범위 목록을 기반으로 합니다. 범위 주 형식이 와일드카드인 경우 범위 주 형식이 일치하고 범위 하위 폼이 와일드카드이거나 범위 주 형식, 범위 하위 형식 및 범위 지정자가 모두 일치하는 세 가지 인스턴스에서 유효성 검사가 성공합니다.

원래 입력 버퍼의 복사본이 전달됩니다. 원래 생성자가 커널 모드가 아니므로 안전하게 액세스할 수 있습니다.

요구 사항