NdisFDirectOidRequest 함수(ndis.h)

아티클
08/07/2023

필터 드라이버는 NdisFDirectOidRequest 함수를 호출하여 기본 드라이버에 직접 OID 요청을 전달하거나 이러한 요청을 시작합니다.

구문

NDIS_STATUS NdisFDirectOidRequest(
  [in] NDIS_HANDLE       NdisFilterHandle,
  [in] PNDIS_OID_REQUEST OidRequest
);

매개 변수

[in] NdisFilterHandle

필터 모듈을 식별하는 NDIS 핸들입니다. NDIS는 FilterAttach 함수 호출에서 필터 드라이버에 핸들을 전달했습니다.

[in] OidRequest

지정된 OID_Xxx 코드로 요청되는 작업을 지정하는 NDIS_OID_REQUEST 구조체에 대한 포인터입니다. 구조체는 OID 쿼리, 집합 또는 메서드 요청을 지정할 수 있습니다.

반환 값

가능한 반환 값 목록은 NdisDirectOidRequest 함수를 참조하세요.

설명

NdisFDirectOidRequest 함수는 일반 OID 요청에 사용할 수 없습니다. 일반 OID 요청의 경우 대신 NdisFOidRequest 함수를 사용합니다. NdisFDirectOidRequest 는 NDIS가 직접 OID 인터페이스에서 사용하도록 지원하는 OID에만 사용할 수 있습니다. 예를 들어 다음 OID를 사용할 수 있습니다.

OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA OID_TCP_TASK_IPSEC_OFFLOAD_V2_UPDATE_SA

필터 드라이버는 NdisFDirectOidRequest를 호출하여 기본 드라이버에 대한 직접 OID 요청을 발생시킬 수 있습니다.

필터 드라이버는 지나치게 드라이버에서 시작된 직접 OID 요청을 필터링할 수도 있습니다. NDIS는 FilterDirectOidRequest 함수를 호출하여 이러한 각 요청을 처리합니다.

NdisFDirectOidRequest가 NDIS_STATUS_PENDING 반환하는 경우 NDIS는 기본 드라이버가 OID 요청을 완료한 후 FilterDirectOidRequestComplete 함수를 호출합니다. NdisFDirectOidRequest를 호출하는 드라이버는 FilterDirectOidRequestComplete 함수를 등록해야 합니다.

드라이버가 다시 시작, 실행 중, 일시 중지 또는 일시 중지 상태일 때 NdisFDirectOidRequest를 호출할 수 있습니다.

직접 OID 요청 인터페이스는 일반 OID 요청 인터페이스와 유사합니다. 일반 요청 발급에 대한 자세한 내용은 NdisFOidRequest를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	NDIS 6.1 이상에서 지원됩니다.
대상 플랫폼	데스크톱
머리글	ndis.h(Ndis.h 포함)
라이브러리	Ndis.lib
IRQL	<= DISPATCH_LEVEL