Funzione PostQueuedCompletionStatus (ioapiset.h)

  • Articolo

Inserisce un pacchetto di completamento di I/O in una porta di completamento di I/O.

Sintassi

BOOL PostQueuedCompletionStatus(
  [in]           HANDLE       CompletionPort,
  [in]           DWORD        dwNumberOfBytesTransferred,
  [in]           ULONG_PTR    dwCompletionKey,
  [in, optional] LPOVERLAPPED lpOverlapped
);

Parametri

[in] CompletionPort

Handle a una porta di completamento di I/O a cui deve essere inviato il pacchetto di completamento di I/O.

[in] dwNumberOfBytesTransferred

Valore da restituire tramite il parametro lpNumberOfBytesTransferred della funzione GetQueuedCompletionStatus .

[in] dwCompletionKey

Valore da restituire tramite il parametro lpCompletionKey della funzione GetQueuedCompletionStatus .

[in, optional] lpOverlapped

Valore da restituire tramite il parametro lpOverlapped della funzione GetQueuedCompletionStatus .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni sull'errore estese, chiamare GetLastError .

Commenti

Il pacchetto di completamento di I/O soddisfa una chiamata in sospeso alla funzione GetQueuedCompletionStatus . Questa funzione restituisce con i tre valori passati come secondo, terzo e quarto parametro della chiamata a PostQueuedCompletionStatus. Il sistema non usa o convalida questi valori. In particolare, il parametro lpOverlapped non deve puntare a una struttura OVERLAPPED .

In Windows 8 e Windows Server 2012 questa funzione è supportata dalle tecnologie seguenti.

Tecnologia Supportato
Protocollo SMB (Server Message Block) 3.0 Sì
Failover trasparente SMB 3.0 (TFO) Sì
SMB 3.0 con condivisioni file con scalabilità orizzontale (SO) Sì
File system del volume condiviso del cluster (CsvFS) Sì
File system resiliente (ReFS) Sì
 

CsvFs eseguirà il reindirizzamento di I/O per i file compressi.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [app desktop | App UWP]
Server minimo supportato Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione ioapiset.h (includere Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

CreateIoCompletionPort

Funzioni di gestione file

GetQueuedCompletionStatus

SOVRAPPOSTA