다음을 통해 공유


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 포함)

참고 항목

NDIS_BIND_PARAMETERS

NDIS_OID_REQUEST

NDIS_PM_CAPABILITIES

NDIS_STATUS_PM_CAPABILITIES_CHANGE