intestazione vmbuskernelmodeclientlibapi.h

Questa intestazione viene usata dalla rete. Per altre informazioni, vedere:

• network

vmbuskernelmodeclientlibapi.h contiene le interfacce di programmazione seguenti:

Funzioni

VMB_CHANNEL_STATE_CHANGE_CALLBACKS_INIT La funzione VMB_CHANNEL_STATE_CHANGE_CALLBACKS_INIT salva le funzioni di callback da usare per le modifiche di stato per un canale.

Funzioni di callback

EVT_VMB_CHANNEL_CLOSED La funzione di callback EvtVmbChannelClosed viene richiamata quando l'endpoint client nella macchina virtuale guest chiude un canale usando la funzione VmbChannelDisable oppure l'endpoint opposto si chiude o chiude il canale.
EVT_VMB_CHANNEL_OPENED La funzione di callback EvtVmbChannelOpened viene richiamata quando l'endpoint client nella macchina virtuale guest apre un canale che è stato offerto.
EVT_VMB_CHANNEL_PNP_FAILURE La funzione di callback EvtChannelPnpFailure viene richiamata se l'endpoint client nella macchina virtuale guest non riesce a connettersi in modo asincrono anche se si trova un dispositivo PnP.
EVT_VMB_CHANNEL_POST_STARTED La funzione di callback EvtVmbChannelPostStarted viene richiamata in entrambi gli endpoint dopo che i pacchetti possono essere ricevuti dall'endpoint opposto.
EVT_VMB_CHANNEL_PROCESS_PACKET La funzione di callback EvtVmbChannelProcessPacket viene richiamata quando un pacchetto arriva nel buffer circolare in ingresso.
EVT_VMB_CHANNEL_PROCESSING_COMPLETE La funzione di callback EvtVmbChannelProcessingComplete viene richiamata quando un gruppo di pacchetti è stato recapitato dalla funzione EvtVmbChannelProcessPacket, se è presente una pausa prima di recapitare pacchetti successivi.
EVT_VMB_CHANNEL_RESTORE_PACKET La funzione di callback EvtVmbChannelRestorePacket viene richiamata quando l'endpoint server del provider di servizi di virtualizzazione deve ripristinare lo stato associato a un oggetto pacchetto.
EVT_VMB_CHANNEL_SAVE_PACKET La funzione di callback EvtVmbChannelSavePacket viene richiamata quando l'endpoint del provider di servizi di virtualizzazione deve salvare lo stato associato a un pacchetto.
EVT_VMB_CHANNEL_STARTED La funzione di callback EvtVmbChannelStarted viene richiamata in entrambi gli endpoint quando un canale è completamente configurato, ma prima che siano stati recapitati pacchetti. Ciò si verifica quando l'endpoint opposto ha aperto il canale o lo ha riaperto dopo averlo chiuso.
EVT_VMB_CHANNEL_SUSPEND La funzione di callback EvtVmbChannelSuspend viene richiamata nell'endpoint server quando il canale viene chiuso o eliminato dall'endpoint client, che sposta il server nello stato Arrestato.
EVT_VMB_PACKET_COMPLETION_ROUTINE La funzione di callback EvtVmbPacketCompletionRoutine viene richiamata al termine della transazione associata a un pacchetto inviato.
FN_VMB_CHANNEL_ALLOCATE La funzione VmbChannelAllocate alloca un nuovo canale VMBus con parametri e callback predefiniti.
FN_VMB_CHANNEL_CLEANUP La funzione VmbChannelCleanup elimina un canale allocato usando la funzione VmbChannelAllocate o inizializzata tramite una funzione di inizializzazione del canale VMBus.
FN_VMB_CHANNEL_CREATE_GPADL_FROM_BUFFER La funzione VmbChannelCreateGpadlFromBuffer crea un elenco di descrittori di indirizzi fisici guest (GPADL) che descrive un buffer sul lato client. GPADL può essere usato nel server per accedere al buffer.
FN_VMB_CHANNEL_CREATE_GPADL_FROM_MDL La funzione VmbChannelCreateGpadlFromMdl crea un elenco di descrittori di indirizzi fisici guest (GPADL) che descrive un buffer sul lato client. GPADL può essere usato nel server per accedere al buffer.
FN_VMB_CHANNEL_DELETE_GPADL La funzione VmbChannelDeleteGpadl elimina un elenco di descrittori di indirizzi fisici guest (GPADL) mappato dalle funzioni VmbChannelCreateGpadlFromMdl o VmbChannelCreateGpadlFromBuffer.
FN_VMB_CHANNEL_DISABLE La funzione VmbChannelDisable disabilita un canale, che lo chiude per i canali client e revoca l'offerta di canale per i canali server. Questa funzione attende fino a quando il canale non viene completamente eliminato prima che venga restituito.
FN_VMB_CHANNEL_ENABLE La funzione VmbChannelEnable abilita un canale nello stato disabilitato connettendosi a VMBus e offrendo o aprendo un canale, in base al tipo di endpoint.
FN_VMB_CHANNEL_GET_INTERFACE_INSTANCE La funzione VmbChannelGetInterfaceInstance ottiene l'istanza dell'interfaccia attiva, ovvero un GUID che identifica in modo univoco un canale.
FN_VMB_CHANNEL_GET_MMIO_SPACE La funzione VmbChannelGetMmioSpace recupera l'indirizzo virtuale del kernel dello spazio MMIO allocato a un canale.
FN_VMB_CHANNEL_GET_POINTER La funzione VmbChannelGetPointer consente a un driver client di recuperare un puntatore salvato in precedenza usando la funzione VmbPacketSetPointer.
FN_VMB_CHANNEL_INIT_SET_CLIENT_CONTEXT_SIZE La funzione VmbChannelInitSetClientContextSize imposta le dimensioni dell'area di contesto facoltativa allocata per il driver client in ogni pacchetto in ingresso.
FN_VMB_CHANNEL_INIT_SET_FLAGS La funzione VmbChannelInitSetFlags imposta i flag comuni agli endpoint del canale server o client.
FN_VMB_CHANNEL_INIT_SET_FRIENDLY_NAME La funzione VmbChannelInitSetFriendlyName imposta il nome descrittivo del canale Della libreria client in modalità kernel (KMCL). Il nome descrittivo viene usato per il debug e la denominazione dell'istanza del contatore delle prestazioni.
FN_VMB_CHANNEL_INIT_SET_MAXIMUM_EXTERNAL_DATA La funzione VmbChannelInitSetMaximumExternalData imposta le dimensioni massime e la lunghezza della catena di dati descritti da un pacchetto, ma non inviati direttamente nel pacchetto. Ovvero la dimensione massima del buffer descritta da externalDataMdl.
FN_VMB_CHANNEL_INIT_SET_MAXIMUM_PACKET_SIZE La funzione VmbChannelInitSetMaximumPacketSize imposta le dimensioni massime del pacchetto che possono essere recapitate tramite un canale, ovvero le dimensioni massime che verranno mai specificate dalla funzione VmbPacketSend.
FN_VMB_CHANNEL_INIT_SET_PROCESS_PACKET_CALLBACKS La funzione VmbChannelInitSetProcessPacketCallbacks imposta le funzioni di callback per l'elaborazione dei pacchetti.
FN_VMB_CHANNEL_INIT_SET_STATE_CHANGE_CALLBACKS La funzione VmbChannelInitSetStateChangeCallbacks imposta funzioni di callback facoltative per le modifiche dello stato.
FN_VMB_CHANNEL_MAP_GPADL La funzione VmbChannelMapGpadl esegue il mapping di un buffer sul lato client nello spazio degli indirizzi fisici sul lato server usando un numero GPADL (Guest Physical Address Descriptor List).
FN_VMB_CHANNEL_PACKET_COMPLETE La funzione VmbChannelPacketComplete pulisce tutti i mapping di memoria in sospeso, rilascia eventuali buffer in uso e, se l'endpoint opposto ha richiesto un pacchetto di completamento, invia un pacchetto di completamento.
FN_VMB_CHANNEL_PACKET_DEFER_TO_PASSIVE La funzione VmbChannelPacketDeferToPassive viene chiamata dal driver client per rinviare un pacchetto passato dalla funzione di callback EvtVmbChannelProcessPacket.
FN_VMB_CHANNEL_PACKET_FAIL La funzione VmbChannelPacketFail non riesce a un pacchetto durante l'elaborazione dei pacchetti a causa di un errore irreversibile. Questa funzione arresta la coda.
FN_VMB_CHANNEL_PACKET_GET_EXTERNAL_DATA La funzione VmbChannelPacketGetExternalData ottiene tutti gli elenchi dei descrittori di memoria esterni associati a un pacchetto durante l'elaborazione dei pacchetti.
FN_VMB_CHANNEL_PAUSE La funzione VmbChannelPause sposta un canale nello stato sospeso, che impedisce un nuovo I/O.
FN_VMB_CHANNEL_RESTORE_FROM_BUFFER La funzione VmbChannelRestoreFromBuffer ripristina lo stato del client dallo stato salvato in precedenza. Il driver deve controllare il valore restituito della funzione.
FN_VMB_CHANNEL_SAVE_BEGIN La funzione VmbChannelSaveBegin inizializza il contesto per salvare lo stato di un canale. Il driver deve controllare il valore restituito della funzione.
FN_VMB_CHANNEL_SAVE_CONTINUE La funzione VmbChannelSaveContinue salva lo stato del canale in un buffer. Eseguire VmbChannelSaveBegin prima di eseguire questa funzione. Il driver deve controllare il valore restituito della funzione.
FN_VMB_CHANNEL_SAVE_END La funzione VmbChannelSaveEnd pulisce tutte le risorse allocate per il salvataggio dello stato di un canale.
FN_VMB_CHANNEL_SEND_SYNCHRONOUS_REQUEST La funzione VmbChannelSendSynchronousRequest invia un pacchetto all'endpoint opposto e attende una risposta.
FN_VMB_CHANNEL_SET_INCOMING_PROCESSING_AT_PASSIVE La funzione VmbChannelSetIncomingProcessingAtPassive imposta la routine IRQL necessaria per l'analisi in ingresso per un canale da PASSIVE_LEVEL.
FN_VMB_CHANNEL_SET_INTERRUPT_LATENCY Aggiornamenti delle macchine virtuali guest alla latenza di monitoraggio in uscita per gli interrupt MNF.
FN_VMB_CHANNEL_SET_POINTER La funzione VmbChannelSetPointer salva un puntatore arbitrario in un contesto di canale.
FN_VMB_CHANNEL_SET_TRANSACTION_QUOTA La funzione VmbChannelSetTransactionQuota imposta la quota di pacchetti in ingresso.
FN_VMB_CHANNEL_SIZEOF_PACKET La funzione VmbChannelSizeofPacket calcola le dimensioni necessarie per i buffer da usare con la funzione VmbPacketInitialize.
FN_VMB_CHANNEL_START La funzione VmbChannelStart sposta un canale fuori dallo stato sospeso.
FN_VMB_CHANNEL_UNMAP_GPADL La funzione VmbChannelUnmapGpadl annulla il mapping di un elenco di descrittori di indirizzi fisici guest (GPADL) mappato usando la funzione VmbChannelMapGpadl. Il buffer non deve più essere in uso dal server prima che venga chiamata questa funzione.
FN_VMB_CLIENT_CHANNEL_INIT_SET_RING_BUFFER_PAGE_COUNT La funzione VmbClientChannelInitSetRingBufferPageCount imposta il numero di pagine di memoria allocate dal client per i buffer circolari in ingresso e in uscita.
FN_VMB_CLIENT_CHANNEL_INIT_SET_TARGET_PNP La funzione VmbClientChannelInitSetTargetPnp imposta la destinazione di un canale client in base al tipo di interfaccia e agli ID istanza.
FN_VMB_CONVERT_VMBUS_HANDLE_TO_KERNEL_HANDLE La funzione VmbConvertVmbusHandleToKernelHandle converte l'handle VMBus in modalità kernel.
FN_VMB_PACKET_ALLOCATE La funzione VmbPacketAllocate alloca un pacchetto dall'elenco lookaside del canale.
FN_VMB_PACKET_FREE La funzione VmbPacketFree rilascia un pacchetto allocato usando la funzione VmbPacketAllocate.
FN_VMB_PACKET_GET_CHANNEL La funzione VmbPacketGetChannel restituisce il canale VMBus a cui è associato un pacchetto VMBus.
FN_VMB_PACKET_GET_POINTER La funzione VmbPacketGetPointer recupera un puntatore salvato in precedenza usando la funzione VmbPacketSetPointer.
FN_VMB_PACKET_INITIALIZE La funzione VmbPacketInitialize inizializza un buffer per contenere un pacchetto VMBus.
FN_VMB_PACKET_RESTORE La funzione VmbPacketRestore ripristina il pacchetto da un buffer che contiene il contesto di pacchetto salvato.
FN_VMB_PACKET_SEND La funzione VmbPacketSend invia i dati in un buffer di pacchetti o in un elenco MDL (Data Descriptor List). La funzione associa tali dati all'oggetto pacchetto VMBus, che rappresenta il pacchetto per tutta la durata della transazione.
FN_VMB_PACKET_SEND_WITH_EXTERNAL_MDL La funzione VmbPacketSendWithExternalMdl invia i dati in un buffer di pacchetti o in un elenco MDL (Data Memory Descriptor List).
FN_VMB_PACKET_SEND_WITH_EXTERNAL_PFNS La funzione VmbPacketSendWithExternalPfns invia i dati in un buffer di pacchetti o dati esterni come matrice di numeri di frame di pagina (PFN).
FN_VMB_PACKET_SET_COMPLETION_ROUTINE La funzione VmbPacketSetCompletionRoutine imposta la routine di completamento per un oggetto packet.
FN_VMB_PACKET_SET_POINTER La funzione VmbPacketSetPointer salva un puntatore arbitrario nel contesto del pacchetto.
FN_VMB_SERVER_CHANNEL_INIT_SET_FLAGS La funzione VmbServerChannelInitSetFlags imposta flag univoci per gli endpoint del canale server.
FN_VMB_SERVER_CHANNEL_INIT_SET_MMIO_MEGABYTES La funzione VmbServerChannelInitSetMmioMegabytes specifica la quantità, megabyte, dello spazio di I/O mappato alla memoria guest (MMIO) da riservare per il dispositivo.
FN_VMB_SERVER_CHANNEL_INIT_SET_SAVE_RESTORE_PACKET_CALLBACKS La funzione VmbServerChannelInitSetSaveRestorePacketCallbacks imposta le funzioni di callback di salvataggio e ripristino chiamate per ogni pacchetto quando il driver chiama una funzione di salvataggio, ad esempio VmbChannelSaveBegin, VmbChannelSaveContinue e VmbChannelSaveEnd o la funzione VmbChannelRestoreFromBuffer.
FN_VMB_SERVER_CHANNEL_INIT_SET_TARGET_INTERFACE_ID La funzione VmbServerChannelInitSetTargetInterfaceId imposta il GUID del tipo di interfaccia di destinazione e il GUID dell'istanza dell'offerta di canale.
FN_VMB_SERVER_CHANNEL_INIT_SET_TARGET_VTL La funzione VmbServerChannelInitSetTargetVtl imposta il VTL di destinazione per questo canale. Il canale verrà offerto ai client in esecuzione nella VTL specificata e nessun altro.
FN_VMB_SERVER_CHANNEL_INIT_SET_VMBUS_HANDLE La funzione VmbServerChannelInitSetVmbusHandle associa un'istanza di VMBus a questo canale.

Strutture

KMCL_SERVER_ONLY_METHODS La struttura KMCL_SERVER_ONLY_METHODS contiene puntatori a funzione per le funzioni solo server per l'interfaccia VMBus Kernel Mode Client Library (KMCL).
KMCL_SERVER_ONLY_METHODS_V5 La struttura KMCL_CLIENT_INTERFACE_V1 contiene puntatori a funzione per le funzioni client per l'interfaccia VMBus Kernel Mode Client Library (KMCL).
VMB_CHANNEL_STATE_CHANGE_CALLBACKS La struttura VMB_CHANNEL_STATE_CHANGE_CALLBACKS contiene funzioni di callback correlate alle modifiche dello stato per un canale.