AFD _ EVENT _ CREATE-Ereignis

Das AFD _ EVENT _ CREATE-Ereignis ist ein Winsock-Netzwerkablaufverfolgungsereignis für einen Socketerstellungsvorgang.

const EVENT_DESCRIPTOR AFD_EVENT_CREATE = {0x3e8, 0x0, 0x10, 0x4, 0xa, 0x3e8, 0x8000000000000004};

Parameter

EnterExit

Informationen zu diesem Ereignis.

In der folgenden Tabelle sind die möglichen Werte für den EnterExit-Parameter aufgeführt:

Wert Bedeutung
0
Der Anfang einer Winsock-Anforderung.
1
Die Winsock-Anforderung wurde abgeschlossen.
2
Der Winsock AFD-Treiber hat eine interne Aktion (z. B. das Abbrechen einer Verbindung) ergriffen.
3
Der TCP/IP-Treiber hat dieses Ereignis verursacht. Dies weist in der Regel auf eine Datenbenachrichtigung hin.
4
Der Winsock AFD-Treiber hat dieses Ereignis verursacht (z. B. durch Festlegen einer Socketoption).

Standort

Ein intern verwendetes privates Feld.

Process

Die EPROCESS-Adresse des Prozesses, der den verknüpften Socket besitzt. Dies ist eine nicht transparente Struktur, die als Prozessobjekt für einen Prozess dient. Weitere Informationen finden Sie in der Windows Driver Kit-Dokumentation für die EPROCESS-Struktur.

Endpunkt

Die _ AFD-ENDPUNKTadresse des Sockets.

Addressfamily

Die Adressfamilienspezifikation für den Socket. Mögliche Werte für die Adressfamilie werden in der Headerdatei Ws2def.h definiert. Beachten Sie, dass die Headerdatei Ws2def.h automatisch in Winsock2.h enthalten ist und niemals direkt verwendet werden sollte.

Die derzeit unterstützten Werte sind AF INET oder AF INET6. Dabei handelt es sich um _ _ die Formate der Internetadressfamilie für IPv4 und IPv6. Andere Optionen für die Adressfamilie _ (z.B. AF NETBIOS für die Verwendung mit NetBIOS) werden unterstützt, wenn ein Windows Sockets-Dienstanbieter für die Adressfamilie installiert ist.

In der folgenden Tabelle sind allgemeine Werte für die Adressfamilie aufgeführt, obwohl viele andere Werte möglich sind.

Af Bedeutung
AF _ UNSPEC
0
Die Adressfamilie ist nicht angegeben.
AF _ INET
2
Die IPv4-Adressfamilie (Internetprotokoll, Version 4).
AF _ IPX
6
Die IPX-/SPX-Adressfamilie. Diese Adressfamilie wird nur unterstützt, wenn das NetBIOS-kompatible Transportprotokoll NWLink IPX/SPX installiert ist.
Diese Adressfamilie wird unter Windows Vista und höher nicht unterstützt.
AF _ APPLETALK
16
Die AppleTalk-Adressfamilie. Diese Adressfamilie wird nur unterstützt, wenn das AppleTalk-Protokoll installiert ist.
Diese Adressfamilie wird unter Windows Vista und höher nicht unterstützt.
AF _ NETBIOS
17
Die NetBIOS-Adressfamilie. Diese Adressfamilie wird nur unterstützt, wenn der Windows Sockets-Anbieter für NetBIOS installiert ist.
Der Windows Sockets-Anbieter für NetBIOS wird in 32-Bit-Versionen von Windows unterstützt. Dieser Anbieter wird standardmäßig auf 32-Bit-Versionen von Windows installiert.
Der Windows Sockets-Anbieter für NetBIOS wird unter 64-Bit-Versionen von Windows nicht unterstützt.
Der Windows Sockets-Anbieter für NetBIOS unterstützt nur Sockets, bei denen der Typparameter auf SOCK _ DGRAM festgelegt ist.
Der Windows Sockets-Anbieter für NetBIOS ist nicht direkt mit der NetBIOS-Programmierschnittstelle verknüpft. Die NetBIOS-Programmierschnittstelle wird unter Windows Vista, Windows Server 2008 und höher nicht unterstützt.
AF _ INET6
23
Die IPv6-Adressfamilie (Internet Protocol Version 6).
AF _ IRDA
26
Die Infrared Data Association(IrDA)-Adressfamilie.
Diese Adressfamilie wird nur unterstützt, wenn auf dem Computer ein Port und treiber installiert sind.
AF _ BTH
32
Die Bluetooth Adressfamilie.
Diese Adressfamilie wird nur unterstützt, wenn auf dem Computer ein Bluetooth Adapter und Treiber installiert sind.

Sockettype

Die Typspezifikation für den neuen Socket. Mögliche Werte für den Sockettyp werden in der Winsock2.h-Headerdatei definiert.

In der folgenden Tabelle sind die möglichen Werte für den Typparameter aufgeführt, der für Windows Sockets 2 unterstützt wird:

type Bedeutung
SOCK _ STREAM
1
Ein Sockettyp, der sequenzierte, zuverlässige, bidirektionierte, verbindungsbasierte Bytestreams mit einem OOB-Datenübertragungsmechanismus bereitstellt. Dieser Sockettyp verwendet das Transmission Control Protocol (TCP) für die Internetadressfamilie (AF _ INET oder AF _ INET6).
SOCK _ DGRAM
2
Ein Sockettyp, der Datagramme unterstützt, bei denen es sich um verbindungslose, unzuverlässige Puffer mit fester (normalerweise kleiner) maximaler Länge handelt. Dieser Sockettyp verwendet das User Datagram Protocol (UDP) für die Internetadressfamilie (AF _ INET oder AF _ INET6).
SOCK _ RAW
3
Ein Sockettyp, der einen unformatierten Socket bereitstellt, mit dem eine Anwendung den nächsten Protokollheader der oberen Ebene bearbeiten kann. Um den IPv4-Header zu bearbeiten, muss die _ IP-HDRINCL-Socketoption für den Socket festgelegt werden. Um den IPv6-Header zu bearbeiten, muss die IPV6 _ HDRINCL-Socketoption für den Socket festgelegt werden.
SOCK _ RDM
4
Ein Sockettyp, der ein zuverlässiges Nachrichtendatendiagramm bereitstellt. Ein Beispiel für diesen Typ ist die PGM-Multicastprotokollimplementierung (PGM) in Windows, die häufig als zuverlässige Multicastprogrammierungbezeichnet wird.
Dieser Typwert wird nur unterstützt, wenn das Reliable Multicast-Protokoll installiert ist.
SOCK _ SEQPACKET
5
Ein Sockettyp, der ein Pseudostreampaket basierend auf Datagrammen bereitstellt.

Protokoll

Das zu verwendende Protokoll. Die möglichen Optionen für den Protokollparameter sind spezifisch für die angegebene Adressfamilie und den angegebenen Sockettyp. Mögliche Werte für das Protokoll werden in der Wsrm.h-Headerdatei und dem IPPROTO-Enumerationstyp definiert, der in der Ws2def.h-Headerdatei definiert ist. Beachten Sie, dass die Headerdatei Ws2def.h automatisch in Winsock2.h enthalten ist und niemals direkt verwendet werden sollte.

Wenn der Wert 0 angegeben wird, möchte der Aufrufer kein Protokoll angeben, und der Dienstanbieter wählt das zu verwendende Protokoll aus.

In der folgenden Tabelle sind allgemeine Werte für das Protokoll aufgeführt, obwohl viele andere Werte möglich sind.

Protokoll Bedeutung
IPPROTO _ ICMP
1
Das Internet Control Message Protocol (ICMP). Dies ist ein möglicher Wert, wenn der af-Parameter AF _ UNSPEC, AF _ INET oder AF _ INET6 ist und der Typparameter SOCK _ RAW oder nicht angegeben ist.
IPPROTO _ IGMP
2
Das Internet Group Management Protocol (IGMP). Dies ist ein möglicher Wert, wenn der af-Parameter AF _ UNSPEC, AF _ INET oder AF _ INET6 ist und der Typparameter SOCK _ RAW oder nicht angegeben ist.
BTHPROTO _ RFCOMM
3
Das Bluetooth RFCOMM-Protokoll (Bluetooth Radio Frequency Communications). Dies ist ein möglicher Wert, wenn der af-Parameter AF _ BTH und der Typparameter SOCK _ STREAM ist.
IPPROTO _ TCP
6
Das Transmission Control Protocol (TCP). Dies ist ein möglicher Wert, wenn der af-Parameter AF _ INET oder AF _ INET6 und der Typparameter SOCK _ STREAM ist.
IPPROTO _ UDP
17
Das User Datagram-Protokoll (UDP). Dies ist ein möglicher Wert, wenn der af-Parameter AF _ INET oder AF _ INET6 und der Typparameter SOCK _ DGRAM ist.
IPPROTO _ ICMPV6
58
Internet Control Message Protocol Version 6 (ICMPv6). Dies ist ein möglicher Wert, wenn der af-Parameter AF _ UNSPEC, AF _ INET oder AF _ INET6 ist und der Typparameter SOCK _ RAW oder nicht angegeben ist.
IPPROTO _ RM
113
Das PGM-Protokoll für zuverlässiges Multicast. Dies ist ein möglicher Wert, wenn der af-Parameter AF _ INET und der Typparameter SOCK _ RDM ist. Dieses Protokoll wird auch als IPPROTO _ PGM bezeichnet.
Dieser Protokollwert wird nur unterstützt, wenn das Reliable Multicast-Protokoll installiert ist.

Processid

Die tatsächliche Prozess-ID oder ein Indikator, wenn das Ereignis das Ergebnis der Ausführung von Winsock-Code in einem Systemprozess oder in einem DPC-Kontext (verzögerter Prozeduraufruf) (Kontexte außerhalb des Benutzerprozesses) war.

Status

Der NTSTATUS-Code für den Vorgang.

Hinweise

Das AFD _ EVENT _ CREATE-Ereignis wird für einen Winsock-Netzwerkvorgang zum Erstellen eines Sockets nachverfolgt. Der Kanal für dieses Ereignis ist Winsock-AFD. Die Ebene für dieses Ereignis ist informational.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
nur Windows 7 [ Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server 2008 [ R2-Desktop-Apps]

Siehe auch

Steuerung der Winsock-Ablaufverfolgung

_EREIGNISBESCHREIBUNG

Winsock-Ablaufverfolgung

Winsock-Ablaufverfolgungsebenen

Details zur Ablaufverfolgung von Winsock-Katalogänderungen