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는 바인딩 작업 중에 기본 네트워크 어댑터의 전원 관리 기능을 PowerManagementCapabilitiesExNDIS_BIND_PARAMETERS 구조의 멤버에 있는 프로토콜 드라이버에 대해 보고합니다. 따라서 프로토콜 드라이버는 OID를 쿼리할 필요가 없습니다.
NDIS는 NDIS_STATUS_PM_CAPABILITIES_CHANGE 상태 표시를 실행하여 지나치게 많은 드라이버에서 사용할 수 있는 전원 관리 기능의 변경 내용을 보고합니다.
기본 네트워크 어댑터에 NDIS 6.1 이전 미니포트 드라이버가 있는 경우 NDIS는 기본 네트워크 어댑터의 전원 관리 기능을 NDIS_PM_CAPABILITIES 구조로 변환합니다.
NDIS는 요청에 대해 다음 상태 코드 중 하나를 반환합니다.
NDIS_STATUS_SUCCESS
요청이 성공적으로 완료되었습니다.
InformationBufferNDIS_PM_CAPABILITIES 구조를 가리킵니다.
NDIS_STATUS_PENDING
요청이 완료 보류 중입니다. NDIS는 요청이 완료된 후 최종 상태 코드와 결과를 호출자의 OID 요청 완료 처리기에 전달합니다.
NDIS_STATUS_BUFFER_TOO_SHORT
정보 버퍼가 너무 짧습니다. NDIS는 DATA를 설정합니다. QUERY_INFORMATION. NDIS_OID_REQUEST 구조체의 BytesNeeded 멤버를 필요한 최소 버퍼 크기로 설정합니다.
NDIS_STATUS_FAILURE
이전 이유 이외의 이유로 요청이 실패했습니다.
요구 사항
버전 |
NDIS 6.20 이상에서 지원됩니다. 미니포트 드라이버에 대해서는 요청되지 않습니다. (설명 섹션 참조) |
머리글 |
Ntddndis.h(Ndis.h 포함) |