Funzione NtAssociateWaitCompletionPacket

Crea un'associazione di completamento di attesa per l'oggetto di destinazione.

Sintassi

NTSTATUS NtAssociateWaitCompletionPacket (
    _In_ HANDLE WaitCompletionPacketHandle,
    _In_ HANDLE IoCompletionHandle,
    _In_ HANDLE TargetObjectHandle,
    _In_opt_ PVOID KeyContext,
    _In_opt_ PVOID ApcContext,
    _In_ NTSTATUS IoStatus,
    _In_ ULONG_PTR IoStatusInformation,
    _Out_opt_ PBOOLEAN AlreadySignaled
    )

Parametri

WaitCompletionPacketHandle [in]

Handle per un pacchetto di completamento di attesa che descrive l'associazione. Questo oggetto non deve essere in uso.

IoCompletionHandle [in]

Handle per un oggetto di completamento I/O che riceverà una notifica quando l'oggetto viene segnalato.

TargetObjectHandle [in]

Handle a un oggetto waitable per cui devono essere ricevute le notifiche.

KeyContext [in]

Fornisce il contesto della chiave restituito durante una chiamata a NtRemoveIoCompletion.

ApcContext [in]

Contesto apc restituito durante una chiamata a NtRemoveIoCompletion.

IoStatus [in]

Dati IoStatus-Status> restituiti durante una chiamata a NtRemoveIoCompletion.

IoStatusInformation [in]

Dati IoStatus-Information> restituiti durante una chiamata a NtRemoveIoCompletion.

AlreadySignaled [out]

Puntatore facoltativo a una variabile booleana che riceve un'indicazione che indica se l'oggetto di destinazione è già stato segnalato al momento dell'associazione quando questa funzione ha esito positivo.

Valore restituito

Codice NTSTATUS. Per altre informazioni, vedere Uso dei valori NTSTATUS.

Commenti

Quando l'oggetto viene segnalato, un pacchetto viene accodato alla porta di completamento fornita e i valori forniti verranno trasmessi a un chiamante di NtRemoveIoCompletion. Quando il pacchetto viene prelevato, è necessario ristabilire l'associazione chiamando nuovamente questa funzione. Se il pacchetto di completamento di attesa è già in uso per un'associazione, viene restituito un errore.

Questa funzione non ha una libreria di importazione o un file di intestazione associato; è necessario chiamarlo usando le funzioni LoadLibrary e GetProcAddress . L'API viene esportata da ntdll.dll.

Requisiti