Función SpbTargetGetFileObject (spbcx.h)
El método SpbTargetGetFileObject acepta, como parámetro de entrada, un identificador SPBTARGET en un dispositivo de destino abierto y devuelve un identificador WDFFILEOBJECT a este destino.
Sintaxis
WDFFILEOBJECT SpbTargetGetFileObject(
[in] SPBTARGET Target
);
Parámetros
[in] Target
Identificador SPBTARGET en un dispositivo de destino en el bus.
Valor devuelto
SpbTargetGetFileObject devuelve un identificador WDFFILEOBJECT a un dispositivo de destino abierto en el bus. El método devuelve NULL si una EvtSpbTargetDisconnect cerró la conexión al destino devolución de llamada de evento.
Observaciones
El controlador del controlador puede llamar a este método para obtener un identificador WDFFILEOBJECT a un dispositivo de destino abierto en el bus. Después, el controlador del controlador SPB puede usar este identificador como parámetro de entrada para los métodos WDF que requieren dicho identificador.
SpbTargetGetFileObject devuelve NULL solo si el identificador WDFFILEOBJECT al destino se cerró, pero antes de cerrarlo, el controlador del CONTROLADOR SPB tomó una referencia adicional en el objeto SBPTARGET para ampliar su duración.
Si se cerró la conexión y el controlador del controlador SPB no contiene referencias al objeto SPBTARGET, el identificador SBPTARGET ya no es válido. Pasar un identificador no válido a spbTargetGetFileObject provoca una comprobación de errores.
Después de spbTargetGetFileObject devuelve un identificador WDFFILEOBJECT, no hay ninguna garantía de que la conexión de destino permanezca abierta a menos que otro objeto (por ejemplo, una solicitud de E/S activa) contenga una referencia al objeto WDFFILEOBJECT para evitar que se cierre inesperadamente. Este método es más útil y, por lo tanto, es más probable que se llame a cuando se garantiza que la conexión de destino esté abierta. Normalmente, estas llamadas se producen durante evtSpbTargetConnect y EvtSpbTargetDisconnect devoluciones de llamada y durante el procesamiento de solicitudes de E/S.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible a partir de Windows 8. |
| de la plataforma de destino de | Universal |
| encabezado de | spbcx.h |
| biblioteca de | Spbcxstubs.lib |
| irQL | <= DISPATCH_LEVEL |