IWDFIoRequest ::GetFileObject, méthode (wudfddi.h)
[Avertissement : UMDF 2 est la dernière version de UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide de UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et il existe une prise en charge limitée de UMDF 1 sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Bien démarrer avec UMDF.]
La méthode GetFileObject récupère un pointeur vers l’interface IWDFFile associée à une requête 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 de fichier. Notez que le retour NULL est valide.
Valeur de retour
Aucun
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 du contexte, ou appelez Release sur l’interface lorsqu’il est terminé.
Exemples
L’exemple de code suivant est extrait 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 de fichier.
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");
}
Exigences
| Exigence | Valeur |
|---|---|
| fin du support | Indisponible dans UMDF 2.0 et versions ultérieures. |
| plateforme cible | Bureau |
| version minimale de UMDF | 1.5 |
| d’en-tête | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |