AtaPortRegistryAllocateBuffer-Funktion (irb.h)

Die AtaPortRegistryAllocateBuffer Routine weist einen Puffer für Registrierungsvorgänge zu.

Hinweis Der ATA-Porttreiber und die ATA Miniport-Treibermodelle können in Zukunft geändert oder nicht verfügbar sein. Stattdessen empfehlen wir die Verwendung des Storport-Treibers und Storport Miniport Treibermodelle.

 

Syntax

PVOID AtaPortRegistryAllocateBuffer(
  [in] PVOID ChannelExtension,
       ULONG BufferSize
);

Parameter

[in] ChannelExtension

Ein Zeiger auf die Kanalerweiterung.

BufferSize

Gibt die Länge des Puffers in Bytes an.

Rückgabewert

AtaPortRegistryAllocateBuffer gibt einen Zeiger auf den zugewiesenen Puffer zurück. Andernfalls wird NULL-zurückgegeben.

Bemerkungen

Der Porttreiber ermöglicht es dem Miniporttreiber, einen Puffer für alle Registrierungsvorgänge zuzuweisen. Nachdem der Miniporttreiber einen Puffer mit AtaPortRegistryAllocateBuffer-zugewiesen hat, schlagen später Aufrufe an AtaPortRegistryAllocateBu ffer fehl und geben NULL-zurück. Nachdem der Miniport-Treiber den zugeordneten Puffer mit einem Aufruf des AtaPortRegistryFreeBuffer Routine freigibt, kann er puffer erneut zuordnen, indem er AtaPortRegistryAllocateBufferaufruft.

Der Miniporttreiber muss AtaPortRegistryAllocateBuffer entweder in seiner AtaChannelInitRoutine Routine oder in der IdeHwControl- Routine aufrufen. AtaPortRegistryAllocateBuffer- kann nicht von einer anderen Routine aufgerufen werden. Darüber hinaus kann der Miniporttreiber nur AtaPortRegistryAllocateBuffer- aus seiner IdeHwControl--Routine aufrufen, wenn die IdeHwControl--Routine aufgerufen wurde und einen Wert von StartChannel oder StopChann el im ControlAction Parameter aufweist.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	irb.h (include Ata.h, Irb.h)
Library	Ataport.lib; Pciidex.lib

Siehe auch

AtaChannelInitRoutine

AtaPortRegistryFreeBuffer

IdeHwControl-