OID_RECEIVE_FILTER_ENUM_QUEUES

아티클
06/15/2023

드라이버와 사용자 모드 애플리케이션을 오버리싱하면 네트워크 어댑터에 할당된 모든 수신 큐 목록을 가져오기 위해 OID_RECEIVE_FILTER_ENUM_QUEUES OID(개체 식별자) 쿼리 요청을 실행합니다.

OID 쿼리 요청에서 성공적으로 반환된 후 NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버에는 NDIS_RECEIVE_QUEUE_INFO_ARRAY 구조체에 대한 포인터가 포함되고 그 뒤에 각 필터에 대한 NDIS_RECEIVE_QUEUE_INFO 구조가 포함됩니다.

설명

NDIS는 OID_RECEIVE_FILTER_ALLOCATE_QUEUE 및 OID_RECEIVE_FILTER_QUEUE_PARAMETERS OID 요청에서 받은 데이터의 내부 캐시에서 정보를 얻었습니다.

드라이버와 사용자 모드 애플리케이션을 과도하게 지정하면 네트워크 어댑터에서 수신 큐를 열거하기 위해 OID_RECEIVE_FILTER_ENUM_QUEUES OID 쿼리 요청을 실행합니다.

프로토콜 드라이버가 요청을 발급하면 NDIS_OID_REQUEST 구조 내의 요청 형식이 NdisRequestQueryInformation 으로 설정되고 이 OID는 프로토콜 드라이버가 네트워크 어댑터에 할당한 모든 수신 큐의 배열을 반환합니다. 사용자 모드 애플리케이션이 요청을 실행한 경우 NDIS_OID_REQUEST 구조 내의 요청 형식이 NdisRequestQueryStatistics로 설정되고 이 OID는 네트워크 어댑터의 모든 수신 큐에 대한 정보 배열을 반환합니다.

반환 상태 코드

NDIS는 미니포트 드라이버에 대한 OID_RECEIVE_FILTER_ENUM_QUEUES OID 쿼리 요청을 처리하고 다음 상태 코드 중 하나를 반환합니다.

상태 코드	Description
NDIS_STATUS_SUCCESS	요청이 성공적으로 완료되었습니다. InformationBuffer는 NDIS_RECEIVE_QUEUE_INFO_ARRAY 구조를 가리킵니다.
NDIS_STATUS_PENDING	요청이 완료될 때까지 보류 중입니다. NDIS는 요청이 완료된 후 최종 상태 코드 및 결과를 호출자의 OID 요청 완료 처리기에 전달합니다.
NDIS_STATUS_INVALID_LENGTH	정보 버퍼가 너무 짧습니다. NDIS는 데이터를 설정합니다. METHOD_INFORMATION. 필요한 최소 버퍼 크기에 대한 NDIS_OID_REQUEST 구조체의 BytesNeeded 멤버입니다.
NDIS_STATUS_FAILURE	다른 이유로 인해 요청이 실패했습니다.