enumerazione WDF_REQUEST_SEND_OPTIONS_FLAGS (wudfddi_types.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. Nessuna nuova funzionalità viene aggiunta 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 informazioni, vedere Introduzione con UMDF.]

Il tipo di enumerazione WDF_REQUEST_SEND_OPTIONS_FLAGS definisce i flag che un driver può specificare quando chiama IWDFIoRequest::Send.

Sintassi

typedef enum _WDF_REQUEST_SEND_OPTIONS_FLAGS {
  WDF_REQUEST_SEND_OPTION_TIMEOUT,
  WDF_REQUEST_SEND_OPTION_SYNCHRONOUS,
  WDF_REQUEST_SEND_OPTION_IGNORE_TARGET_STATE,
  WDF_REQUEST_SEND_OPTION_SEND_AND_FORGET,
  WDF_REQUEST_SEND_OPTION_IMPERSONATE_CLIENT,
  WDF_REQUEST_SEND_OPTION_IMPERSONATION_IGNORE_FAILURE
} WDF_REQUEST_SEND_OPTIONS_FLAGS;

Costanti

 
WDF_REQUEST_SEND_OPTION_TIMEOUT
Se impostato, il parametro Timeout del metodo IWDFIoRequest::Send è valido.
WDF_REQUEST_SEND_OPTION_SYNCHRONOUS
Se impostato, UMDF invia in modo sincrono la richiesta di I/O.
WDF_REQUEST_SEND_OPTION_IGNORE_TARGET_STATE
Se impostato, UMDF invia la richiesta di I/O alla destinazione di I/O, indipendentemente dallo stato della destinazione di I/O. Se non è impostato, UMDF accoda la richiesta se la destinazione viene arrestata. L'impostazione di questo flag consente a un driver di inviare una richiesta, ad esempio una richiesta di reimpostazione di una pipe USB, su un dispositivo dopo che il driver ha chiamato IWDFIoTargetStateManagement::Stop.
WDF_REQUEST_SEND_OPTION_SEND_AND_FORGET
Se impostato, il driver invia la richiesta in modo asincrono e non deve ricevere una notifica quando la richiesta viene completata o annullata. Il driver non imposta una funzione di callback IRequestCallbackRequestCompletion::OnCompletion callback o chiama IWDFIoRequest::Complete per la richiesta. Per altre informazioni su questo flag, vedere la sezione Osservazioni seguenti.
WDF_REQUEST_SEND_OPTION_IMPERSONATE_CLIENT
Se impostato e se il tipo di richiesta I/O è WdfRequestCreate, il metodo Send tenta di passare il livello di rappresentazione del client alla destinazione I/O del driver. Questo valore è disponibile nelle versioni 1.9 di UMDF e versioni successive.
WDF_REQUEST_SEND_OPTION_IMPERSONATION_IGNORE_FAILURE
Se impostato, UMDF ignora gli errori di rappresentazione. È possibile usare questo valore solo con WDF_REQUEST_SEND_OPTION_IMPERSONATE_CLIENT. Questo valore è disponibile nelle versioni 1.9 di UMDF e versioni successive.

Commenti

Un driver che imposta il flag di WDF_REQUEST_SEND_OPTION_SEND_AND_FORGET in genere non formatta la richiesta di I/O prima di chiama IWDFIoRequest::Send per inviare la richiesta a una destinazione di I/O. Infatti, un driver che imposta questo flag non deve chiamare nessuno dei metodi IWdfIoTarget::FormatRequestForXxx prima di chiama IWDFIoRequest::Send. Il driver può usare solo il metodo IWDFIoRequest::FormatUsingCurrentType per formattare la richiesta.

Il driver non può impostare il flag di WDF_REQUEST_SEND_OPTION_SEND_AND_FORGET se il parametro pIoTarget di IWDFIoRequest::Send punta a un oggetto di destinazione I/O basato su handle file. Per altre informazioni su questo tipo di destinazione di I /O, vedere Inizializzazione di una destinazione di I/O generale in UMDF.

Se il driver imposta il flag di WDF_REQUEST_SEND_OPTION_SEND_AND_FORGET, non può impostare altri flag tranne WDF_REQUEST_SEND_OPTION_IMPERSONATE_CLIENT e WDF_REQUEST_SEND_OPTION_IMPERSONATION_IGNORE_FAILURE.

Per altre informazioni sulla rappresentazione client, vedere Gestione della rappresentazione client.

Per la versione kmDF di questa enumerazione, vedere WDF_REQUEST_SEND_OPTIONS_FLAGS.

Requisiti

Requisito Valore
Versione UMDF minima 1,0
Intestazione wudfddi_types.h (includere Wudfddi.h)

Vedi anche

IWDFIoRequest::Send