Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
[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 Réutiliser réinitialise un objet de requête d’infrastructure afin qu’elle puisse être réutilisée.
Syntaxe
void Reuse(
[in] HRESULT hrNewStatus
);
Paramètres
[in] hrNewStatus
Valeur d’état typée HRESULT affectée par l’infrastructure à la demande.
Valeur de retour
Aucun
Remarques
Si un pilote basé sur l’infrastructure appelle IWDFDevice ::CreateRequest pour créer des objets de requête, le pilote peut réutiliser ces objets de requête. Les pilotes peuvent également réutiliser les objets de requête qu’ils reçoivent de l’infrastructure dans leurs files d’attente d’E/S.
Un pilote peut réutiliser un objet de requête une fois la requête d’origine terminée. Une fois qu’un pilote a appelé Réutiliser, le contenu de la requête doit être réinitialisé.
Si vous souhaitez que la demande réutilisée ait une fonction de rappel IRequestCallbackRequestCompletion ::OnCompletion fonction de rappel, le pilote doit appeler IWDFIoRequest ::SetCompletionCallback après avoir appelé Réutiliser.
Pour plus d’informations sur réutiliser, consultez réutilisation des objets de requête framework.
Exemples
L’exemple de code suivant montre comment une fonction de rappel IRequestCallbackRequestCompletion ::OnCompletion peut obtenir l’interface IWDFIoRequest2, puis appeler Réutiliser.
void
STDMETHODCALLTYPE
CMyRemoteDevice::OnCompletion(
__in IWDFIoRequest* FxRequest,
__in IWDFIoTarget* FxTarget,
__in IWDFRequestCompletionParams* Params,
__in void* Context
)
{
...
CComQIPtr<IWDFIoRequest2> fxRequest2(FxRequest);
fxRequest2->Reuse(S_OK);
...
}
Exigences
| Exigence | Valeur |
|---|---|
| fin du support | Indisponible dans UMDF 2.0 et versions ultérieures. |
| plateforme cible | Bureau |
| version minimale de UMDF | 1.9 |
| d’en-tête | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |