Função SpbTargetGetFileObject (spbcx.h)
O método SpbTargetGetFileObject aceita, como um parâmetro de entrada, um identificador SPBTARGET para um dispositivo de destino aberto e retorna um identificador WDFFILEOBJECT para esse destino.
Sintaxe
WDFFILEOBJECT SpbTargetGetFileObject(
[in] SPBTARGET Target
);
Parâmetros
[in] Target
Um identificador SPBTARGET para um dispositivo de destino no barramento.
Valor de retorno
SpbTargetGetFileObject retorna um identificador WDFFILEOBJECT para um dispositivo de destino aberto no barramento. O método retornará NULL se a conexão com o destino tiver sido fechada por um EvtSpbTargetDisconnect retorno de chamada de evento.
Observações
O driver do controlador pode chamar esse método para obter um identificador WDFFILEOBJECT para um dispositivo de destino aberto no barramento. O driver do controlador SPB pode usar esse identificador como um parâmetro de entrada para métodos WDF que exigem esse identificador.
SpbTargetGetFileObject retorna NULL somente se o identificador WDFFILEOBJECT para o destino foi fechado, mas, antes de ser fechado, o driver do controlador SPB fez uma referência adicional no objeto SBPTARGET para estender seu tempo de vida.
Se a conexão tiver sido fechada e o driver do controlador SPB não tiver referências ao objeto SPBTARGET, o identificador SBPTARGET não será mais válido. Passar um identificador inválido para SpbTargetGetFileObject causa uma verificação de bug.
Após SpbTargetGetFileObject retornar um identificador WDFFILEOBJECT, não há garantia de que a conexão de destino permanecerá aberta, a menos que outro objeto (por exemplo, uma solicitação de E/S ativa) mantenha uma referência ao objeto WDFFILEOBJECT para impedir que ele feche inesperadamente. Esse método é mais útil e, portanto, provavelmente será chamado quando a conexão de destino tiver a garantia de estar aberta. Normalmente, essas chamadas ocorrem durante EvtSpbTargetConnect e EvtSpbTargetDisconnect retornos de chamada e durante o processamento de solicitações de E/S.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível a partir do Windows 8. |
| da Plataforma de Destino | Universal |
| cabeçalho | spbcx.h |
| biblioteca | Spbcxstubs.lib |
| IRQL | <= DISPATCH_LEVEL |