Funzione SpbTargetGetFileObject (spbcx.h)
Il metodo SpbTargetGetFileObject accetta, come parametro di input, un handle SPBTARGET in un dispositivo di destinazione aperto e restituisce un handle WDFFILEOBJECT a questa destinazione.
Sintassi
WDFFILEOBJECT SpbTargetGetFileObject(
[in] SPBTARGET Target
);
Parametri
[in] Target
Handle SPBTARGET a un dispositivo di destinazione sul bus.
Valore restituito
SpbTargetGetFileObject restituisce un handle WDFFILEOBJECT a un dispositivo di destinazione aperto sul bus. Il metodo restituisce NULL se la connessione alla destinazione è stata chiusa da un EvtSpbTargetDisconnect callback dell'evento.
Osservazioni
Il driver del controller può chiamare questo metodo per ottenere un handle WDFFILEOBJECT in un dispositivo di destinazione aperto sul bus. Il driver del controller SPB può quindi usare questo handle come parametro di input per i metodi WDF che richiedono tale handle.
SpbTargetGetFileObject restituisce NULL solo se l'handle WDFFILEOBJECT alla destinazione è stato chiuso ma, prima della chiusura, il driver del controller SPB ha preso un riferimento aggiuntivo sull'oggetto SBPTARGET per estenderne la durata.
Se la connessione è stata chiusa e il driver del controller SPB non contiene riferimenti all'oggetto SPBTARGET, l'handle SBPTARGET non è più valido. Il passaggio di un handle non valido a SpbTargetGetFileObject causa un controllo dei bug.
Dopo SpbTargetGetFileObject restituisce un handle WDFFILEOBJECT, non esiste alcuna garanzia che la connessione di destinazione rimanga aperta a meno che un altro oggetto (ad esempio, una richiesta di I/O attiva) contenga un riferimento all'oggetto WDFFILEOBJECT per impedirne la chiusura imprevista. Questo metodo è più utile e, pertanto, è più probabile che venga chiamato, quando la connessione di destinazione è garantita l'apertura. In genere, tali chiamate si verificano durante EvtSpbTargetConnect e EvtSpbTargetDisconnect callback e durante l'elaborazione delle richieste di I/O.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile a partire da Windows 8. |
| piattaforma di destinazione | Universale |
| intestazione | spbcx.h |
| libreria | Spbcxstubs.lib |
| IRQL | <= DISPATCH_LEVEL |