RegisterPowerRelationship
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função estabelece dinâmico pai e filho ou relacionamento driver barramento e cliente. Fique disponível para drivers que energia gerenciar um conjunto de dependente drivers filho e cliente.
Syntax
HANDLE RegisterPowerRelationship(
PVOID pvParent,
PVOID pvChild,
PPOWER_CAPABILITIES pCaps,
DWORD Flags
);
Parameters
- pvParent
[no] Nome dispositivo LPWStr do pai ou barramento, de exemplo, NDS0:.
- pvChild
[no] Nome dispositivo LPWStr do filho ou cliente, de exemplo, NE20001.
- pCaps
[no] Ponteiro para o POWER_CAPABILITIES do dispositivo filho. Definir como NULL se não usado.
- Sinalizadores
[no] Definido como POWER_NAME para indicar que pvParent e pvChild São nomes dispositivo.
Return Value
- ERROR_FILE_EXISTS
Indica que o dispositivo filho já está registrado.
- ERROR_INVALID_PARAMETER
Indica que inválido parâmetro foram encontrados.
- ERROR_SUCCESS
Indica que o relacionamento foi estabelecido com êxito.
Remarks
O pai pode registrar cada exclusivamente nomeado instância filho, quando necessário.
Se pCaps é NULL, o pai deve ser preparada para identificador IOCTL_POWER_CAPABILITIES para o filho.
O proprietário do identificador retornado deve livre com ReleasePowerRelationship quando o relacionamento é não mais exigido.
See Also
Reference
IOCTL_POWER_CAPABILITIES
POWER_CAPABILITIES
ReleasePowerRelationship