Funzione SpbTargetGetFileObject (spbcx.h)

  • Articolo

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 per un dispositivo di destinazione nel bus.

Valore restituito

SpbTargetGetFileObject restituisce un handle WDFFILEOBJECT a un dispositivo di destinazione aperto nel bus. Il metodo restituisce NULL se la connessione alla destinazione è stata chiusa da un callback dell'evento EvtSpbTargetDisconnect .

Commenti

Il driver del controller può chiamare questo metodo per ottenere un handle WDFFILEOBJECT a un dispositivo di destinazione aperto nel bus. Il driver del controller SPB può quindi usare questo handle come parametro di input per i metodi WDF che richiedono un handle di questo tipo.

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 estendere 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. Se si passa un handle non valido a SpbTargetGetFileObject , viene generato un controllo di bug.

Dopo che 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, è molto probabile che venga chiamata, quando la connessione di destinazione è garantita l'apertura. In genere, tali chiamate si verificano durante i callback EvtSpbTargetConnect e EvtSpbTargetDisconnect e durante l'elaborazione delle richieste di I/O.

Requisiti

Requisito Valore
Client minimo supportato Disponibile a partire da Windows 8.
Piattaforma di destinazione Universale
Intestazione spbcx.h
Libreria Spbcxstubs.lib
IRQL <= DISPATCH_LEVEL

Vedi anche

EvtSpbTargetConnect

EvtSpbTargetDisconnect

SPBTARGET