OID_RECEIVE_FILTER_QUEUE_PARAMETERS
오버리싱 드라이버는 수신 큐의 현재 구성 매개 변수를 얻기 위해 OID_RECEIVE_FILTER_QUEUE_PARAMETERS OID(개체 식별자) 메서드 요청을 실행합니다. NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버에는 NDIS_RECEIVE_QUEUE_ID 형식의 큐 식별자가 있는 NDIS_RECEIVE_QUEUE_PARAMETERS 구조체에 대한 포인터가 포함되어 있습니다. OID 메서드 요청에서 성공적으로 반환된 후 NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버에는 NDIS_RECEIVE_QUEUE_PARAMETERS 구조체에 대한 포인터가 포함됩니다.
오버리싱 드라이버는 큐의 현재 구성 매개 변수를 변경하기 위해 OID_RECEIVE_FILTER_QUEUE_PARAMETERS OID 집합 요청을 실행합니다. 오버리싱 드라이버는 NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버에서 NDIS_RECEIVE_QUEUE_PARAMETERS 구조체에 대한 포인터를 제공합니다.
설명
오버리싱 드라이버는 하나 이상의 수신 큐의 매개 변수를 변경하기 위해 OID_RECEIVE_FILTER_QUEUE_PARAMETERS OID 집합 요청을 실행합니다. OID 집합 요청은 NDIS 6.20 이상 미니포트 드라이버에 대해 선택 사항입니다. 그러나 VMQ(가상 머신 큐) 인터페이스를 지원하는 미니포트 드라이버에는 OID 요청이 필수입니다.
참고 큐를 할당한 지나치게 많은 드라이버만 OID_RECEIVE_FILTER_QUEUE_PARAMETERS OID 집합 요청을 실행하여 구성 매개 변수를 변경할 수 있습니다.
오버리싱 드라이버는 이전 OID_RECEIVE_FILTER_ALLOCATE_QUEUE 메서드 OID 요청에서 큐 식별자 입력 값을 얻었습니다.
오버리싱 드라이버가 큐를 할당한 후 NDIS_RECEIVE_QUEUE_PARAMETERS 구조의Flags 멤버에 해당하는 변경 플래그(NDIS_RECEIVE_QUEUE_PARAMETER_Xxx_CHANGED)가 있는 구성 매개 변수를 변경할 수 있습니다. 그러나 큐가 할당된 후에는 오버리싱 드라이버가 해당 변경 플래그가 없는 구성 매개 변수를 변경할 수 없습니다.
반환 상태 코드
NDIS는 미니포트 드라이버에 대한 OID_RECEIVE_FILTER_QUEUE_PARAMETERS OID 메서드 요청을 처리하고 다음 상태 코드 중 하나를 반환합니다.
| 상태 코드 | Description |
|---|---|
NDIS_STATUS_SUCCESS |
요청이 성공적으로 완료되었습니다. |
NDIS_STATUS_PENDING |
요청이 완료될 때까지 보류 중입니다. NDIS는 요청이 완료된 후 최종 상태 코드 및 결과를 호출자의 OID 요청 완료 처리기에 전달합니다. |
NDIS_STATUS_INVALID_LENGTH |
정보 버퍼가 너무 짧습니다. NDIS는 데이터를 설정합니다. METHOD_INFORMATION. 필요한 최소 버퍼 크기로 NDIS_OID_REQUEST 구조체의 BytesNeeded 멤버입니다. |
NDIS_STATUS_INVALID_PARAMETER |
기본 네트워크 어댑터가 지원하지 않는 기능을 사용하도록 설정하려고 했기 때문에 요청이 실패했습니다. |
NDIS_STATUS_FAILURE |
다른 이유로 인해 요청이 실패했습니다. |
요구 사항
Version |
NDIS 6.20 이상에서 지원됩니다. |
헤더 |
Ntddndis.h(Ndis.h 포함) |