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
Un identificador SPBTARGET para 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 devolución de llamada de evento EvtSpbTargetDisconnect cerró la conexión al destino.
Comentarios
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 este identificador.
SpbTargetGetFileObject devuelve NULL solo si el identificador WDFFILEOBJECT del destino se cerró, pero antes de cerrarlo, el controlador del controlador SPB tomó una referencia adicional en el objeto SBPTARGET para extender 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 que SpbTargetGetFileObject devuelva 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, lo más probable es llamar a cuando se garantiza que la conexión de destino está abierta. Normalmente, estas llamadas se producen durante las devoluciones de llamada EvtSpbTargetConnect y EvtSpbTargetDisconnect y durante el procesamiento de solicitudes de E/S.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible a partir de Windows 8. |
| Plataforma de destino | Universal |
| Encabezado | spbcx.h |
| Library | Spbcxstubs.lib |
| IRQL | <= DISPATCH_LEVEL |