Funzione StorPortIssueDpc (storport.h)

Articolo
02/29/2024

La routine StorPortIssueDpc genera una chiamata di procedura posticipata (DPC).

Sintassi

BOOLEAN StorPortIssueDpc(
  [in] PVOID     DeviceExtension,
  [in] PSTOR_DPC Dpc,
  [in] PVOID     SystemArgument1,
  [in] PVOID     SystemArgument2
);

Parametri

[in] DeviceExtension

Puntatore all'estensione del dispositivo per adattatore.

[in] Dpc

Puntatore a un buffer contenente un oggetto DPC inizializzato di tipo STOR_DPC restituito dalla routine StorPortInitializeDpc .

[in] SystemArgument1

Puntatore a informazioni fornite dal chiamante che verranno passate alla routine posticipata.

[in] SystemArgument2

Puntatore a informazioni fornite dal chiamante che verranno passate alla routine posticipata.

Valore restituito

La routine StorPortIssueDpc restituisceTRUE se il DPC è stato inserito correttamente nella coda DPC e false in caso contrario.

Commenti

La routine StorPortIssueDpc chiama la routine kernel KeInsertQueueDpc per accodare il DPC. La routine kernel KeInsertQueueDpc non consente la coda di un DPC più volte. Pertanto, se l'oggetto DPC specificato dal parametro Dpc è già nella coda DPC , KeInsertQueueDpc ignora la richiesta di coda. Ciò garantisce che una routine posticipata inizializzata con StorPortInitializeDpc sia sempre sincronizzata con se stessa. In altre parole, il chiamante non deve sequenziare le chiamate alla routine StorPortIssueDpc per garantire che più istanze della routine non vengano eseguite contemporaneamente.

Se un driver miniport include più elementi di lavoro che devono essere eseguiti dallo stesso DPC, il driver miniport deve assicurarsi che ogni elemento di lavoro venga completato prima di emettere il DPC per l'elemento di lavoro successivo.