IServerVirtualDeviceSet2::RequestBuffers (VDI)

Gilt für: SQL Server

Mit der RequestBuffers-Funktion wird die VDI darüber informiert, dass der Server eine bestimmte Anzahl von Puffern mit einer bestimmten Größen- und Ausrichtungsanforderung benötigt.

Syntax

HRESULT IServerVirtualDeviceSet2::RequestBuffers (
   DWORD   dwSize,
   DWORD   dwAlignment,
   DWORD   dwCount
);

Parameter

dwSize: Gibt die Größe der einzelnen Puffer an. Diese Größe sollte nur den für die Daten benötigten Bereich umfassen. Die VDI übernimmt alle Ausrichtungs- und Präfixanforderungen.

dwAlignment: Die für diese Puffer erforderliche Ausrichtung. Dies kann ein restriktiverer Wert als der mit „BeginConfiguration“ angegebene Basisausrichtungswert sein. Wenn der Wert 0 ist, wird er standardmäßig auf den Basisausrichtungswert gesetzt.

dwCount: Die Anzahl der Puffer, die von „AllocateBuffer“ mit der festgelegten Größe und Ausrichtung angefordert werden.

Rückgabewert

Rückgabewert	Erklärung
NOERROR	Die Funktion wurde erfolgreich ausgeführt.
VD_E_ABORT	Ein Abbruch wurde angefordert.
VD_E_PROTOCOL	Der Satz weist keinen Status auf, in dem Pufferzuweisungen deklariert werden können (siehe Statusübergangsmatrix).
VD_E_MEMORY	Der angeforderte Arbeitsspeicher konnte nicht abgerufen werden.

Hinweise

Diese Methode sollte verwendet werden, bevor Puffer mit „AllocateBuffer“ zugewiesen werden. Mehrere Puffer mit einer bestimmten Größe und Ausrichtung werden mit der „RequestBuffers“-Funktion angefordert, und anschließend werden einzelne Puffer mit „AllocateBuffer“ zugewiesen.

Während der Konfigurationsphase werden die „RequestBuffers“-Aufrufe „zusammengefasst“, sodass beim „EndConfiguration“-Aufruf ein einzelner Pufferbereich verwendet werden kann (er wird dann zugewiesen). Nach Abschluss der Konfiguration führen alle „RequestBuffer“-Aufrufe zu einer sofortigen Zuweisung von mehr Pufferspeicher.

Nächste Schritte

Weitere Informationen finden Sie in der Referenz zur Schnittstelle für virtuelle Geräte in SQL Server.