MINIPORT_CO_CREATE_VC Rückruffunktion (ndis.h)

Die MiniportCoCreateVc Funktion ist für verbindungsorientierte Miniports erforderlich. MiniportCoCreateVc- wird von NDIS aufgerufen, um dem Miniporttreiber anzugeben, dass eine neue VC erstellt wird.

Syntax

MINIPORT_CO_CREATE_VC MiniportCoCreateVc;

NDIS_STATUS MiniportCoCreateVc(
  [in]  NDIS_HANDLE MiniportAdapterContext,
  [in]  NDIS_HANDLE NdisVcHandle,
  [out] PNDIS_HANDLE MiniportVcContext
)
{...}

Parameter

[in] MiniportAdapterContext

Gibt das Handle für einen kontextbezogenen Miniporttreiberbereich an, in dem der Miniporttreiber Zustandsinformationen zu dieser Instanz des Adapters verwaltet. Der Miniporttreiber hat diesen Handle durch Aufrufen von NDIS bereitgestellt. von NdisMSetMiniportAttributes MiniportInitializeEx Funktion.

[in] NdisVcHandle

Gibt ein Handle an, das von NDIS bereitgestellt wird, das das erstellte VC eindeutig identifiziert. Dieses Handle ist für den Miniporttreiber undurchsichtig und für die Verwendung der NDIS-Bibliothek reserviert.

[out] MiniportVcContext

Gibt bei der Ausgabe einen Handle für einen vom Miniport-Treiber bereitgestellten Kontextbereich an, in dem der Miniporttreiber den Zustand über die VC verwaltet.

Rückgabewert

Bemerkungen

MiniportCoCreateVc- muss als synchrone Funktion geschrieben werden und kann unter keinen Umständen NDIS_STATUS_PENDING zurückgeben, ohne einen systemweiten Fehler zu verursachen.

MiniportCoCreateVc weist alle erforderlichen Ressourcen zu, die der Miniporttreiber benötigt, um Zustandsinformationen über die VC zu verwalten. Die Ressourcen können enthalten, sind jedoch nicht auf Speicherpuffer, Ereignisse, Datenstrukturen und andere ähnliche Ressourcen beschränkt.

Nach der Zuordnung aller erforderlichen Ressourcen sollte der Miniporttreiber die Ressourcen in einen verwendbaren Zustand initialisieren und einen Zeiger in den Zustandsbereich in MiniportVcContextzurückgeben. Das Handle wird festgelegt, indem der Handle abgeleitet und ein Zeiger auf den Zustandspuffer als Wert des Handles gespeichert wird. Zum Beispiel:

*MiniportVcContext = SomeBuffer;

Miniport-Treiber müssen den Handle auf dem VC speichern, NdisVcHandlein ihrem Zustandsbereich, da es ein erforderlicher Parameter für andere NDIS-Bibliotheksroutinen ist, die anschließend vom Miniporttreiber aufgerufen werden.

beispiele für

Um beispielsweise eine MiniportCoCreateVc--Funktion zu definieren, die den Namen "MyCoCreateVc" hat, verwenden Sie den MINIPORT_CO_CREATE_VC Typ, wie in diesem Codebeispiel gezeigt:

MINIPORT_CO_CREATE_VC MyCoCreateVc;

Implementieren Sie dann Ihre Funktion wie folgt:

_Use_decl_annotations_
NDIS_STATUS
 MyCoCreateVc(
    NDIS_HANDLE  MiniportAdapterContext,
    NDIS_HANDLE  NdisVcHandle,
    PNDIS_HANDLE  MiniportVcContext
    )
  {...}

Der MINIPORT_CO_CREATE_VC Funktionstyp wird in der Ndis.h-Headerdatei definiert. Um Fehler genauer zu identifizieren, wenn Sie die Codeanalysetools ausführen, müssen Sie der Funktionsdefinition die Use_decl_annotations Anmerkung hinzufügen. Die Use_decl_annotations Anmerkung stellt sicher, dass die Anmerkungen, die auf den Funktionstyp MINIPORT_CO_CREATE_VC in der Headerdatei angewendet werden, verwendet werden. Weitere Informationen zu den Anforderungen für Funktionsdeklarationen finden Sie unter Deklarieren von Funktionen mithilfe von Funktionsrollentypen für NDIS-Treiber.

Informationen zu Use_decl_annotationsfinden Sie unter Annotating Function Behavior.

Anforderungen

Siehe auch

MiniportInitializeEx-

NdisMSetMiniportAttributes