IF_QUERY_OBJECT 콜백 함수(ndis.h)

  • 아티클

ProviderQueryObject 함수는 네트워크 인터페이스에 대한 정보를 검색합니다.

구문

IF_QUERY_OBJECT IfQueryObject;

NDIS_STATUS() IfQueryObject(
  [in]      NDIS_HANDLE ProviderIfContext,
  [in]      NET_IF_OBJECT_ID ObjectId,
  [in, out] PULONG pOutputBufferLength,
  [out]     PVOID pOutputBuffer
)
{...}

매개 변수

[in] ProviderIfContext

인터페이스에 대한 인터페이스 공급자의 컨텍스트 영역을 식별하는 핸들입니다. 인터페이스 공급자는 에 대한 호출에서 이 핸들을 NDIS에 전달했습니다. NdisIfRegisterInterface 함수입니다.

[in] ObjectId

쿼리 요청의 대상인 개체의 식별자입니다. 인터페이스 공급자에 적용되는 OID(개체 식별자) 목록은 NDIS 네트워크 인터페이스 OID를 참조하세요.

[in, out] pOutputBufferLength

NDIS가 출력 버퍼의 길이를 제공하는 NDIS 제공 변수에 대한 포인터입니다. ProviderQueryObject 는 출력 버퍼에 넣은 데이터의 길이를 씁니다.

[out] pOutputBuffer

ProviderQueryObject가 쿼리 요청에 응답을 쓰는 NDIS 제공 출력 버퍼에 대한 포인터입니다.

반환 값

ProviderQueryObject는 다음 상태 값 중 하나를 반환합니다.

반환 코드 설명
NDIS_STATUS_SUCCESS
 작업이 성공적으로 완료되었습니다.
NDIS_STATUS_RESOURCES
 리소스가 부족하여 작업이 실패했습니다.
NDIS_STATUS_INVALID_PARAMETER
 일부 입력 매개 변수가 잘못되어 호출이 실패했습니다.
NDIS_STATUS_Xxx
 다른 이유로 인해 호출이 실패했습니다. 이 함수는 호출하는 함수에서 오류 코드를 전파하거나 적절한 오류 코드를 생성할 수 있습니다.

설명

NDIS는 네트워크 인터페이스 공급자의 ProviderQueryObject 함수를 호출하여 공급자가 등록한 인터페이스에 대한 정보를 가져옵니다. 인터페이스 공급자에 적용되는 OID 목록은 NDIS 네트워크 인터페이스 OID를 참조하세요.

NDIS는 IRQL = PASSIVE_LEVEL ProviderQueryObject 를 호출합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 NDIS 6.0 이상에서 지원됩니다.
대상 플랫폼 Windows
헤더 ndis.h(Ndis.h 포함)
IRQL PASSIVE_LEVEL

추가 정보

NdisIfRegisterInterface