Metodo IWDFIoRequest::GetFileObject (wudfddi.h)
[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre info, vedi Introduzione con UMDF.]
Il metodo GetFileObject recupera un puntatore all'interfaccia IWDFFile associata a una richiesta di I/O.
Sintassi
void GetFileObject(
[out] IWDFFile **ppFileObject
);
Parametri
[out] ppFileObject
Puntatore a un buffer che riceve un puntatore all'interfaccia IWDFFile per l'oggetto file. Si noti che la restituzione di NULL è valida.
Valore restituito
nessuno
Osservazioni
Quando il driver chiama GetFileObject, il framework incrementa il conteggio dei riferimenti sull'interfaccia. Il driver è responsabile del rilascio del riferimento al termine del puntatore all'interfaccia. A tale scopo, usare un puntatore intelligente che decrementa automaticamente il conteggio dei riferimenti quando l'oggetto esce dal contesto oppure chiamare Release sull'interfaccia al termine dell'operazione.
Esempio
L'esempio di codice seguente è tratto dall'esempio WpdMultiTransportDriver in WDK. L'esempio dichiara un puntatore intelligente a un'interfaccia IWDFFile , chiama GetFileObject e quindi chiama RetrieveContext nell'oggetto file.
CComPtr<IWDFFile> pFileObject;
...
// Get the Context map for this client
pRequest->GetFileObject(&pFileObject);
if (pFileObject != NULL)
{
hr = pFileObject->RetrieveContext((void**)&pClientContextMap);
CHECK_HR(hr, "Failed to get Contextmap from WDF File Object");
}
Requisiti
| Requisito | Valore |
|---|---|
| Fine del supporto | Non disponibile in UMDF 2.0 e versioni successive. |
| Piattaforma di destinazione | Desktop |
| Versione UMDF minima | 1.5 |
| Intestazione | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |