KsFastMethodHandler 함수(ks.h)

KsFastMethodHandler 함수는 IOCTL_KS_METHOD 통해 요청된 빠른 메서드를 처리합니다. 빠른 I/O 목록에 포함된 집합으로 정의된 모든 메서드 식별자에 응답합니다. 이 함수는 PASSIVE_LEVEL 호출할 수 있습니다.

구문

KSDDKAPI BOOLEAN KsFastMethodHandler(
  [in]      PFILE_OBJECT       FileObject,
  [in]      PKSMETHOD          Method,
  [in]      ULONG              MethodLength,
  [in, out] PVOID              Data,
  [in]      ULONG              DataLength,
  [out]     PIO_STATUS_BLOCK   IoStatus,
  [in]      ULONG              MethodSetsCount,
  [in]      const KSMETHOD_SET *MethodSet
);

매개 변수

[in] FileObject

요청이 이루어진 파일 개체를 지정합니다.

[in] Method

원래 메서드 매개 변수를 지정합니다. 이것은 항상 FILE_LONG_ALIGNMENT 있지만 FILE_QUAD_ALIGNMENT 않을 수 있습니다.

[in] MethodLength

메서드 매개 변수의 호출자가 나타내는 길이를 지정합니다.

[in, out] Data

원래 정렬되지 않은 데이터 매개 변수를 지정합니다.

[in] DataLength

데이터 매개 변수의 호출자가 나타내는 길이를 지정합니다.

[out] IoStatus

오류 상태 및 정보를 반환하는 데 사용되는 정렬된 구조를 지정합니다.

[in] MethodSetsCount

전달되는 메서드 집합 구조체의 수를 나타냅니다.

[in] MethodSet

메서드 집합 정보 목록에 대한 포인터를 지정합니다.

반환 값

KsFastMethodHandler 함수는 요청이 처리되면 TRUE를 반환하고, 요청이 처리되지 않으면 FALSE를 반환합니다. 요청이 처리되지 않으면 IRP가 생성됩니다. 요청이 처리된 경우 함수는 내부 오류로 인해 IoStatus-Information> 요소를 0으로 설정하거나 메서드 처리기에서 요소를 설정합니다. 메서드 처리기는 메서드가 처리될 때 IoStatus-Status> 필드도 설정합니다.

설명

메서드 집합의 소유자는 KsFastMethodHandler 및 KsMethodHandler 함수를 사용하여 메서드 처리의 사전 필터링 또는 사후 필터링을 수행할 수 있습니다. KsFastMethodHandler 함수는 디바이스 제어에 대한 빠른 I/O 디스패치 인터페이스를 통해 이루어진 요청을 처리하는 데 사용됩니다. 신속하게 처리할 수 있는 요청을 처리하는 데만 사용됩니다. 빠른 I/O 함수의 Wait 매개 변수는 전달되지 않으며 TRUE로 간주됩니다.

요구 사항

추가 정보

KsMethodHandler