Funzione WdfIoTargetWdmGetTargetFileObject (wdfiotarget.h)
[Si applica solo a KMDF]
Il metodo WdfIoTargetWdmGetTargetFileObject restituisce un puntatore all'oggetto file WDM (Windows Driver Model) associato a una destinazione di I/O remota specificata.
Sintassi
PFILE_OBJECT WdfIoTargetWdmGetTargetFileObject(
[in] WDFIOTARGET IoTarget
);
Parametri
[in] IoTarget
Handle a un oggetto di destinazione di I/O remoto. Questo handle è stato ottenuto da una chiamata precedente a WdfIoTargetCreate.
Valore restituito
WdfIoTargetWdmGetTargetFileObject restituisce un puntatore a una struttura di FILE_OBJECT WDM.
Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.
Commenti
Il puntatore restituito dal metodo WdfIoTargetWdmGetTargetFileObject è valido fino a quando il driver chiama WdfIoTargetClose o WdfIoTargetCloseForQueryRemove o fino all'eliminazione dell'oggetto di destinazione I/O remoto. Se il driver fornisce una funzione EvtCleanupCallback per l'oggetto di destinazione di I/O remoto e se l'oggetto viene eliminato prima della chiusura della destinazione di I/O remota, il puntatore è valido fino a quando non viene restituita la funzione EvtCleanupCallback .
Se il driver tenta di accedere all'oggetto dispositivo WDM dopo che è stato rimosso, il driver può causare l'arresto anomalo del sistema. L'esempio di avviso popup illustra come il driver può fornire una funzione di callback EvtIoTargetQueryRemove in modo che venga notificata se la destinazione di I/O viene rimossa.
Per altre informazioni su WdfIoTargetWdmGetTargetFileObject, vedere Ottenere informazioni su una destinazione di I/O generale.
Per altre informazioni sulle destinazioni di I/O, vedere Uso delle destinazioni di I/O.
Esempio
Nell'esempio di codice seguente viene ottenuto un puntatore all'oggetto file WDM associato a una destinazione di I/O remota.
PFILE_OBJECT pfileObject;
pfileObject = WdfIoTargetWdmGetTargetFileObject(IoTarget);
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.0 |
| Intestazione | wdfiotarget.h (include Wdf.h) |
| Libreria | Wdf01000.sys (vedere Framework Library Versioning). |
| IRQL | <=DISPATCH_LEVEL |
| Regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |