KsMethodHandlerWithAllocator 함수(ks.h)

KsMethodHandlerWithAllocator 함수는 동일한 제한으로 KsMethodHandler와 동일한 처리를 수행하지만 선택적 할당자 콜백을 사용하여 매개 변수에 대한 버퍼를 제공할 수 있습니다. 필터를 사용하는 경우 일부 비전통적인 방식으로 버퍼를 해제해야 할 수 있습니다. 사용자 지정 할당자를 사용할 때는 IRP_BUFFERED_IO 및 IRP_DEALLOCATE_BUFFER 플래그가 설정되지 않습니다.

구문

KSDDKAPI NTSTATUS KsMethodHandlerWithAllocator(
  [in]           PIRP               Irp,
  [in]           ULONG              MethodSetsCount,
  [in]           const KSMETHOD_SET *MethodSet,
  [in, optional] PFNKSALLOCATOR     Allocator,
  [in, optional] ULONG              MethodItemSize
);

매개 변수

[in] Irp

처리 중인 메서드 요청이 있는 IRP를 지정합니다.

[in] MethodSetsCount

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

[in] MethodSet

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

[in, optional] Allocator

필요에 따라 메서드 매개 변수를 저장하기 위해 메모리를 할당하는 데 사용할 할당 함수를 가리킵니다.

[in, optional] MethodItemSize

필요에 따라 각 메서드 목록에서 각 KSMETHOD_ITEM 구조체의 크기를 포함합니다. 개인 정보를 저장하기 위해 메서드 항목을 확장할 수 있습니다. 이 매개 변수가 0이면 구조체 크기가 정상으로 간주됩니다. 메서드 항목 구조보다 크거나 같은 경우 사용자 지정 데이터를 검색할 수 있도록 KSMETHOD_ITEM_IRP_STORAGE 매크로를 사용하여 메서드 항목에 대한 포인터를 반환할 수 있습니다. 64비트 플랫폼에서 이 매개 변수는 8의 배수여야 합니다.

반환 값

KsMethodHandler 함수는 성공하면 STATUS_SUCCESS 반환하거나, 실패한 경우 처리 중인 메서드와 관련된 오류를 반환합니다. 함수는 항상 IO_STATUS_BLOCK 설정합니다. PIRP의 정보 필드입니다. 내부 오류로 인해 IRP 내의 IoStatus 요소를 0으로 설정하거나 메서드 처리기에 의해 요소가 설정됩니다. 함수가 IO_STATUS_BLOCK 설정하지 않습니다. 상태 필드 또는 IRP를 완료합니다.

64비트 플랫폼에서 PropertyItemSize 매개 변수가 8의 배수가 아닌 경우 STATUS_INVALID_PARAMETER 반환되고 호출이 실패합니다.

요구 사항

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