OID_PM_PARAMETERS

쿼리로 프로토콜 드라이버는 OID_PM_PARAMETERS OID를 사용하여 현재 사용하도록 설정된 네트워크 어댑터의 전원 관리 하드웨어 기능을 쿼리할 수 있습니다. OID 쿼리 요청에서 성공적으로 반환된 후 NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버에는 NDIS_PM_PARAMETERS 구조체에 대한 포인터가 포함됩니다.

집합으로 프로토콜 드라이버는 OID_PM_PARAMETERS OID를 사용하여 네트워크 어댑터의 현재 하드웨어 기능을 사용하거나 사용하지 않도록 설정할 수 있습니다. 프로토콜 드라이버는 NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버에 있는 NDIS_PM_PARAMETERS 구조체에 대한 포인터를 제공합니다.

설명

NDIS 6.20부터 지나치게 많은 프로토콜 및 필터 드라이버는 OID_PM_PARAMETERS 사용하여 현재 사용하도록 설정된 네트워크 어댑터의 전원 관리 하드웨어 기능을 쿼리하고 설정합니다.

지나치게 많은 드라이버가 OID_PM_PARAMETERS OID를 쿼리하면 NDIS는 미니포트 드라이버에 전달하지 않고 요청을 완료합니다. NDIS는 요청된 설정을 저장하고 이러한 다른 요청의 설정과 결합합니다. NDIS가 네트워크 어댑터를 저전력 상태로 전환하기 전에 NDIS는 NDIS가 저장한 모든 요청의 결합된 설정을 포함하는 미니포트 드라이버에 집합 요청을 보냅니다.

현재 사용하도록 설정된 기능은 하드웨어에서 지원하는 기능의 하위 집합일 수 있습니다. 하드웨어에서 지원하는 기능에 대한 자세한 내용은 OID_PM_HARDWARE_CAPABILITIES 참조하세요.

참고 NDIS가 NDIS_PM_PARAMETERS 구조체의 WakeUpFlags 멤버에서 NDIS_PM_SELECTIVE_SUSPEND_ENABLED 플래그를 설정하는 경우 OID_PM_PARAMETERS OID 집합 요청을 미니포트 드라이버에 직접 발급합니다. 이를 통해 NDIS는 네트워킹 드라이버 스택의 필터 드라이버에 의한 처리를 바이패스할 수 있습니다.

NDIS 또는 미니포트 드라이버는 요청에 대한 다음 상태 코드 중 하나를 반환합니다.

NDIS_STATUS_SUCCESS
요청이 성공적으로 완료되었습니다.

NDIS_STATUS_PENDING
요청이 완료될 때까지 보류 중입니다. NDIS는 요청이 완료된 후 최종 상태 코드 및 결과를 호출자의 OID 요청 완료 처리기에 전달합니다.

NDIS_STATUS_BUFFER_TOO_SHORT
정보 버퍼가 너무 짧습니다. NDIS는 데이터를 설정합니다 . QUERY_INFORMATION. 필요한 최소 버퍼 크기에 대한 NDIS_OID_REQUEST 구조체의 BytesNeeded 멤버입니다.

NDIS_STATUS_INVALID_PARAMETER
기본 네트워크 어댑터가 지원하지 않는 기능을 사용하도록 설정하려고 했기 때문에 요청이 실패했습니다.

NDIS_STATUS_FAILURE
이전 이유 이외의 이유로 요청이 실패했습니다.

요구 사항

Version	NDIS 6.20 이상에서 지원됩니다.
헤더	Ntddndis.h(Ndis.h 포함)

추가 정보

NDIS_OID_REQUEST

NDIS_PM_PARAMETERS

OID_PM_HARDWARE_CAPABILITIES