OID_PM_CURRENT_CAPABILITIES
쿼리로, 오버리싱 드라이버는 OID_PM_CURRENT_CAPABILITIES OID를 사용하여 네트워크 어댑터의 현재 사용 가능한 전원 관리 기능을 쿼리할 수 있습니다. OID 쿼리 요청에서 성공적으로 반환된 후 NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버에는 NDIS_PM_CAPABILITIES 구조체에 대한 포인터가 포함됩니다.
설명
NDIS는 미니포트 드라이버에 대한 쿼리를 처리합니다. NDIS 6.20부터 미니포트 드라이버는 초기화 중에 전원 관리 하드웨어 기능을 제공합니다. 그러나 NDIS는 프로토콜 드라이버에서 일부 기능을 숨길 수 있습니다. 예를 들어 NDIS는 사용자가 전원 관리 기능의 일부 또는 전체를 사용하지 않도록 설정할 때 다른 기능을 보고할 수 있습니다.
NDIS가 프로토콜 드라이버에 보고하는 현재 전원 관리 기능이 미니포트 드라이버가 NDIS에 보고한 하드웨어 기능과 반드시 동일하지는 않습니다.
NDIS는 바인딩 작업 중 NDIS_BIND_PARAMETERS 구조체의 PowerManagementCapabilitiesEx 멤버에 있는 프로토콜 드라이버에 기본 네트워크 어댑터의 전원 관리 기능을 보고합니다. 따라서 프로토콜 드라이버는 OID를 쿼리할 필요가 없습니다.
NDIS는 오버리딩 드라이버에서 사용할 수 있는 전원 관리 기능의 변경 내용을 보고하는 NDIS_STATUS_PM_CAPABILITIES_CHANGE 상태 표시를 발급합니다.
기본 네트워크 어댑터에 NDIS 6.1 또는 이전 미니포트 드라이버가 있는 경우 NDIS는 기본 네트워크 어댑터의 전원 관리 기능을 NDIS_PM_CAPABILITIES 구조로 변환합니다.
NDIS는 요청에 대해 다음 상태 코드 중 하나를 반환합니다.
NDIS_STATUS_SUCCESS
요청이 성공적으로 완료되었습니다. InformationBuffer는 NDIS_PM_CAPABILITIES 구조를 가리킵니다.
NDIS_STATUS_PENDING
요청이 완료될 때까지 보류 중입니다. NDIS는 요청이 완료된 후 최종 상태 코드와 결과를 호출자의 OID 요청 완료 처리기에 전달합니다.
NDIS_STATUS_BUFFER_TOO_SHORT
정보 버퍼가 너무 짧습니다. NDIS는 데이터를 설정합니다 . QUERY_INFORMATION. 필요한 최소 버퍼 크기에 대한 NDIS_OID_REQUEST 구조체의 BytesNeeded 멤버입니다.
NDIS_STATUS_FAILURE
이전 이유 이외의 이유로 요청이 실패했습니다.
요구 사항
Version |
NDIS 6.20 이상에서 지원됩니다. 미니포트 드라이버에 대해 요청되지 않았습니다. 설명 부분을 참조하십시오. |
헤더 |
Ntddndis.h(Ndis.h 포함) |