funzione WDF_IO_QUEUE_CONFIG_INIT (wdfio.h)

Articolo
02/29/2024

[Si applica a KMDF e UMDF]

La funzione WDF_IO_QUEUE_CONFIG_INIT inizializza la struttura di WDF_IO_QUEUE_CONFIG di un driver.

Sintassi

void WDF_IO_QUEUE_CONFIG_INIT(
  [out] PWDF_IO_QUEUE_CONFIG       Config,
  [in]  WDF_IO_QUEUE_DISPATCH_TYPE DispatchType
);

Parametri

[out] Config

Puntatore alla struttura WDF_IO_QUEUE_CONFIG del driver.

[in] DispatchType

Enumeratore WDF_IO_QUEUE_DISPATCH_TYPE che identifica il tipo di invio delle richieste per la coda.

Valore restituito

nessuno

Osservazioni

I driver devono chiamare WDF_IO_QUEUE_CONFIG_INIT quando si crea una coda di I/O gestita da energia che non è la coda predefinita di un dispositivo. La funzione WDF_IO_QUEUE_CONFIG_INIT zero la struttura di WDF_IO_QUEUE_CONFIG specificata e imposta il relativo membro Size . Imposta anche il membro PowerManaged su WdfUseDefault e archivia il tipo di invio specificato nel membro DispatchType .

A partire da KMDF versione 1.9, se DispatchType è impostato su WdfIoQueueDispatchParallel, WDF_IO_QUEUE_CONFIG_INIT imposta il membro NumberOfPresentedRequests della struttura su -1. Questo valore indica che il framework può recapitare un numero illimitato di richieste di I/O al driver.

Esempio

L'esempio di codice seguente inizializza WDF_IO_QUEUE_CONFIG struttura e quindi chiama WdfIoQueueCreate.

WDF_IO_QUEUE_CONFIG  queueConfig;
NTSTATUS  status = STATUS_SUCCESS;
WDFQUEUE  readQueue;

WDF_IO_QUEUE_CONFIG_INIT(
                         &queueConfig,
                         WdfIoQueueDispatchManual
                         );
status = WdfIoQueueCreate(
                          hDevice,
                          &queueConfig,
                          WDF_NO_OBJECT_ATTRIBUTES,
                          &readQueue
                          );