FwpsAcquireWritableLayerDataPointer0 함수(fwpsk.h)

아티클
08/07/2023

FwpsAcquireWritableLayerDataPointer0 함수는 검사하고 변경할 수 있는 계층별 데이터를 반환합니다.

참고FwpsAcquireWritableLayerDataPointer0 은 특정 버전의 FwpsAcquireWritableLayerDataPointer입니다. 자세한 내용은 WFP Version-Independent 이름 및 특정 버전의 Windows 대상 지정 을 참조하세요.

구문

NTSTATUS FwpsAcquireWritableLayerDataPointer0(
  [in]      UINT64             classifyHandle,
  [in]      UINT64             filterId,
  [in]      UINT32             flags,
  [out]     PVOID              *writableLayerData,
  [in, out] FWPS_CLASSIFY_OUT0 *classifyOut
);

매개 변수

[in] classifyHandle

분류 요청에 대한 핸들입니다. 이 핸들은 를 호출하여 가져옵니다. FwpsAcquireClassifyHandle0.

[in] filterId

classifyFn 함수의 filter 매개 변수에 대한 FilterId 멤버의 값 입니다. FilterId 멤버에 대한 자세한 내용은 FWPS_FILTER1.

[in] flags

다음에 사용하도록 예약됩니다. 0으로 설정됩니다.

[out] writableLayerData

계층에 대한 수정 가능한 데이터를 포함하는 데이터 버퍼입니다. 다음 주의 섹션에 나열된 지원되는 데이터 형식은 구조체로 정의됩니다. 반환 시 void 포인터를 적절한 구조체 형식으로 캐스팅하여 데이터에 액세스할 수 있습니다.

[in, out] classifyOut

를 콜아웃 드라이버의 classifyFn 함수의 classifyOut 매개 변수로 설정합니다. classifyFn의 classifyOut 매개 변수는 헤더에 출력 매개 변수로 나열되지만 FwpsAcquireWritableLayerDataPointer0에 전달될 때 엔진에 유용할 만큼 입력에 대한 충분한 정보가 포함되어 있습니다.

반환 값

FwpsAcquireWritableLayerDataPointer0 함수는 다음 NTSTATUS 코드 중 하나를 반환합니다.

반환 코드	설명
STATUS_SUCCESS	콜백 함수가 성공적으로 등록되었습니다.
기타 상태 코드	오류가 발생했습니다.

설명

FwpsAcquireWritableLayerDataPointer0 은 FWPS_CLASSIFY_OUT0 구조체의 다음 멤버를 설정합니다.

classifyOut->actionType = FWP_ACTION_BLOCK
classifyOut->rights &= ~FWPS_RIGHT_ACTION_WRITE

이 함수에 대한 모든 호출에 대해 설명선 드라이버가 데이터를 수정하지 않은 경우에도 FwpsApplyModifiedLayerData0 에 일치하는 호출을 수행하여 변경된 내용을 완료해야 합니다. FwpsApplyModifiedLayerData0을 호출하지 않으면 분류가 올바르게 완료되지 않을 수 있습니다.

다음 구조체는 수정 가능한 계층 데이터를 포함하도록 정의됩니다. 출력에서 writableLayerData 매개 변수로 설정된 포인터를 다음 형식 중 하나로 캐스팅할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7부터 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	fwpsk.h(Fwpsk.h 포함)
라이브러리	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL