Méthode IWDFIoRequest ::GetFileObject (wudfddi.h)

Article
02/27/2024

[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.]

La méthode GetFileObject récupère un pointeur vers l’interface IWDFFile associée à une demande d’E/S.

Syntaxe

void GetFileObject(
  [out] IWDFFile **ppFileObject
);

Paramètres

[out] ppFileObject

Pointeur vers une mémoire tampon qui reçoit un pointeur vers l’interface IWDFFile pour l’objet file. Notez que le retour de la valeur NULL est valide.

Valeur de retour

None

Remarques

Lorsque votre pilote appelle GetFileObject, l’infrastructure incrémente le nombre de références sur l’interface. Votre pilote est chargé de libérer la référence lorsque vous avez terminé avec le pointeur d’interface. Pour ce faire, utilisez un pointeur intelligent qui décrémente automatiquement le nombre de références lorsque l’objet sort de son contexte, ou appelez Release sur l’interface lorsque vous en avez terminé.

Exemples

L’exemple de code suivant est tiré de l’exemple WpdMultiTransportDriver dans wdk. L’exemple déclare un pointeur intelligent vers une interface IWDFFile , appelle GetFileObject, puis appelle RetrieveContext sur l’objet 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");
  }

Configuration requise

Condition requise	Valeur
Fin de la prise en charge	Non disponible dans UMDF 2.0 et versions ultérieures.
Plateforme cible	Desktop (Expérience utilisateur)
Version UMDF minimale	1.5
En-tête	wudfddi.h (inclure Wudfddi.h)
DLL	WUDFx.dll

Voir aussi

IWDFFile

IWDFIoRequest

Partager via