função de retorno de chamada PCAM_STATE_ROUTINE (usbcamdi.h)
[CamRestoreState não tem suporte e pode ser alterado ou indisponível no futuro. ]
A função de retorno de chamada de estado de um minidriver de câmera restaura um estado de contexto do dispositivo salvo anteriormente ou salva o estado de contexto do dispositivo atual.
Sintaxe
PCAM_STATE_ROUTINE PcamStateRoutine;
NTSTATUS PcamStateRoutine(
PDEVICE_OBJECT BusDeviceObject,
PVOID DeviceContext
)
{...}
Parâmetros
BusDeviceObject
Ponteiro para o objeto de dispositivo do minidriver da câmera criado pelo hub USB.
Para CamSaveState, esse valor pode ser NULL.
DeviceContext
Ponteiro para o contexto do dispositivo do minidriver da câmera.
Retornar valor
Essa rotina de retorno de chamada deve retornar STATUS_SUCCESS.
Comentários
Sobre CamRestoreState
O USBCAMD chama a função de retorno de chamada CamRestoreState do minidriver no contexto de uma solicitação de SRB_CHANGE_POWER_STATE quando o estado de energia está indo de OFF para ON (D3 para D0).
O USBCAMD ignora o valor retornado do CamRestoreState do minidriver.
CamRestoreState é chamado pelas versões 1.0 e 2.0 do USBCAMD.
Essa função é opcional.
Sobre CamSaveState
O USBCAMD versão 1.0 chama CamSaveState do minidriver no contexto de uma solicitação de SRB_CHANGE_POWER_STATE em que o estado de energia está indo de ATIVADO para DESATIVADO (D0 para D3).
O USBCAMD ignora o valor retornado da função de retorno de chamada CamSaveState do minidriver.
CamSaveState é chamado pelas versões 1.0 e 2.0 do USBCAMD.
Essa função é opcional.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível em versões do sistema operacional Windows antes do Windows XP. |
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | usbcamdi.h (inclua Usbcamdi.h) |