Compartilhar via


OID_PM_HARDWARE_CAPABILITIES

Como uma consulta, os drivers sobrepostos podem usar o OID OID_PM_HARDWARE_CAPABILITIES para consultar os recursos de hardware de gerenciamento de energia de um adaptador de rede. Após um retorno bem-sucedido da solicitação de consulta OID, o membro InformationBuffer da estrutura NDIS_OID_REQUEST contém um ponteiro para uma estrutura de NDIS_PM_CAPABILITIES .

Comentários

O NDIS manipula a consulta para drivers de miniporta. A partir do NDIS 6.20, os drivers de miniporto fornecem os recursos de hardware de gerenciamento de energia durante a inicialização no membro PowerManagementCapabilitiesEx da estrutura NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES .

O driver de miniporta deve emitir uma indicação NDIS_STATUS_PM_CAPABILITIES_CHANGE status para relatar alterações nas funcionalidades de hardware de gerenciamento de energia de um adaptador de rede para NDIS e drivers excessivamente.

O NDIS retorna um dos seguintes códigos de status para a solicitação:

NDIS_STATUS_SUCCESS
A solicitação foi concluída com êxito. O InformationBuffer aponta para uma estrutura NDIS_PM_CAPABILITIES .

NDIS_STATUS_PENDING
A solicitação está pendente de conclusão. O NDIS passará o código de status final e os resultados para o manipulador de conclusão de solicitação OID do chamador após a conclusão da solicitação.

NDIS_STATUS_BUFFER_TOO_SHORT
O buffer de informações era muito curto. O NDIS define os DADOS. QUERY_INFORMATION. Membro BytesNeeded na estrutura NDIS_OID_REQUEST para o tamanho mínimo do buffer necessário.

NDIS_STATUS_FAILURE
A solicitação falhou por motivos diferentes dos motivos anteriores.

Requisitos

Versão

Com suporte no NDIS 6.20 e posterior. Não solicitado para drivers de miniporta. (Consulte a seção Observações.)

Cabeçalho

Ntddndis.h (inclua Ndis.h)

Confira também

NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES

NDIS_OID_REQUEST

NDIS_PM_CAPABILITIES

NDIS_STATUS_PM_CAPABILITIES_CHANGE