Metodo IWDFIoRequest::GetFileObject (wudfddi.h)

  • Articolo

[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

Vedi anche

IWDFFile

IWDFIoRequest