NDK_FN_CREATE_COMPLETION funzione di callback (ndkpi.h)

Articolo
02/26/2024

La funzione NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) completa la creazione di un oggetto NDK.

Sintassi

NDK_FN_CREATE_COMPLETION NdkFnCreateCompletion;

void NdkFnCreateCompletion(
  [in, optional] PVOID Context,
  [in]           NTSTATUS Status,
  [in]           NDK_OBJECT_HEADER *pNdkObject
)
{...}

Parametri

[in, optional] Context

Valore di contesto passato al provider NDK quando un consumer chiama una funzione di creazione di oggetti. La funzione di creazione fornisce il contesto con il puntatore della funzione NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) della richiesta di completamento asincrona.

[in] Status

Stato di completamento asincrono per la richiesta di creazione. Per ogni tipo di oggetto, vedere le funzioni di creazione dell'oggetto , ad esempio NDK_FN_CREATE_CQ, per i codici di stato di completamento che possono essere restituiti per ogni tipo di oggetto.

[in] pNdkObject

Puntatore a un'intestazione dell'oggetto NDK (NDK_OBJECT_HEADER).

Valore restituito

nessuno

Osservazioni

Nota Questa funzione viene implementata dal consumer NDK e passata al provider NDK.

Gli oggetti NDK vengono creati con funzioni asincrone. Queste funzioni di creazione di oggetti asincrone accettano un puntatore NDK_FN_CREATE_COMPLETION funzione come parametro di input.

Un provider NDK può restituire STATUS_PENDING da una funzione di creazione di oggetti asincrona. In questo caso, il provider NDK deve chiamare la funzione di completamento per indicare che la creazione dell'oggetto è stata completata.

Qualsiasi altro codice di stato indica il completamento inline. In questo caso, il provider non deve chiamare la funzione di completamento della richiesta di creazione. Se la funzione create request restituisce un codice di stato NT_STATUS diverso da STATUS_PENDING, l'oggetto creato deve essere restituito in un parametro di output con la funzione create request.

Per creare richieste che restituiscono STATUS_PENDING e versioni successive complete con STATUS_SUCCESS in modo asincrono, l'oggetto creato deve essere restituito dalla funzione di completamento della creazione con il parametro pNdkObject e il provider non deve accedere al parametro di output dell'oggetto della funzione di richiesta di creazione.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuna supportata, supportata in NDIS 6.30 e versioni successive.
Server minimo supportato	Windows Server 2012
Piattaforma di destinazione	Windows
Intestazione	ndkpi.h (include Ndkpi.h)
IRQL	<=DISPATCH_LEVEL