Função SpbTargetGetFileObject (spbcx.h)
O método SpbTargetGetFileObject aceita, como 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.
Retornar valor
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 retorno de chamada de evento EvtSpbTargetDisconnect .
Comentários
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 retornará NULL somente se o identificador WDFFILEOBJECT para o destino tiver sido 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 foi fechada e o driver do controlador SPB não contém referências ao objeto SPBTARGET, o identificador SBPTARGET não é mais válido. Passar um identificador inválido para SpbTargetGetFileObject causa um bug marcar.
Depois que 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 os retornos de chamada EvtSpbTargetConnect e EvtSpbTargetDisconnect e durante o processamento de solicitações de E/S.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível a partir do Windows 8. |
| Plataforma de Destino | Universal |
| Cabeçalho | spbcx.h |
| Biblioteca | Spbcxstubs.lib |
| IRQL | <= DISPATCH_LEVEL |