HW_STREAM_OBJECT 구조체(strmini.h)
HW_STREAM_OBJECT 미니 드라이버 스트림의 인스턴스를 설명합니다.
통사론
typedef struct _HW_STREAM_OBJECT {
ULONG SizeOfThisPacket;
ULONG StreamNumber;
PVOID HwStreamExtension;
PHW_RECEIVE_STREAM_DATA_SRB ReceiveDataPacket;
PHW_RECEIVE_STREAM_CONTROL_SRB ReceiveControlPacket;
HW_CLOCK_OBJECT HwClockObject;
BOOLEAN Dma;
BOOLEAN Pio;
PVOID HwDeviceExtension;
ULONG StreamHeaderMediaSpecific;
ULONG StreamHeaderWorkspace;
BOOLEAN Allocator;
PHW_EVENT_ROUTINE HwEventRoutine;
ULONG Reserved[2];
} HW_STREAM_OBJECT, *PHW_STREAM_OBJECT;
회원
SizeOfThisPacket
이 구조체의 크기(바이트)를 지정합니다.
StreamNumber
미니 드라이버의 HW_STREAM_DESCRIPTOR 구조 내에서 스트림의 오프셋을 지정합니다.
HwStreamExtension
이 스트림에 대한 개인 정보를 보유하는 데 사용할 미니 드라이버에 대해 클래스 드라이버에서 할당한 버퍼인 스트림 확장을 가리킵니다. 미니 드라이버는 스트림 클래스 드라이버에 자신을 등록할 때 통과하는 HW_INITIALIZATION_DATA 구조에서 버퍼의 크기를 설정합니다.
ReceiveDataPacket
스트림의 StrMiniReceiveStreamDataPacket 루틴에 대한 포인터입니다.
ReceiveControlPacket
스트림의 StrMiniReceiveStreamControlPacket 루틴에 대한 포인터입니다.
HwClockObject
스트림의 클록 개체를 포함합니다. 자세한 내용은 HW_CLOCK_OBJECT 참조하세요.
Dma
TRUE 경우 디바이스는 DMA를 사용하여 이 스트림에 대한 데이터를 전송합니다.
Pio
TRUE 경우 디바이스는 프로그래밍된 I/O를 사용하여 이 스트림에 대한 데이터를 전송합니다. Pio 및 Dma 멤버는 모두 TRUE 수 있습니다.
HwDeviceExtension
미니 드라이버의 디바이스 확장에 대한 포인터입니다. 미니 드라이버는 이 버퍼를 사용하여 개인 정보를 기록할 수 있습니다. 미니 드라이버는 StreamClassRegisterMinidriver통해 자신을 등록할 때 통과하는 HW_INITIALIZATION_DATA 구조에서 이 버퍼의 크기를 설정합니다. 또한 클래스 드라이버는 HW_STREAM_REQUEST_BLOCK, HW_TIME_CONTEXT및 미니 드라이버에 전달하는 PORT_CONFIGURATION_INFORMATION 구조체의 HwDeviceExtension 멤버에서 이 버퍼에 대한 포인터를 전달합니다.
StreamHeaderMediaSpecific
미디어별 스트림별 헤더 확장의 크기(바이트)를 지정합니다.
StreamHeaderWorkspace
스트림 헤더당 작업 영역의 크기를 지정합니다.
Allocator
드라이버에서 할당자를 사용하는 경우 TRUE 지정합니다. 대부분의 미니 드라이버는 이 값을 FALSE 설정합니다.
HwEventRoutine
스트림의 StrMiniEvent 루틴에 대한 포인터
Reserved[2]
시스템 사용을 위해 예약되어 있습니다. 사용하지 마세요.
발언
이 구조체는 미니 드라이버에서 특정 스트림에 대한 정보를 보관하기 위해 클래스 드라이버에 의해 생성됩니다. 각 스트림별 요청에 대해 클래스 드라이버는 스트림 요청 블록의 StreamObject 멤버에서 스트림에 대한 HW_STREAM_OBJECT 전달합니다(HW_STREAM_REQUEST_BLOCK참조).
클래스 드라이버가 스트림을 열고 미니 드라이버의 StrMiniReceiveDevicePacket 루틴에 SRB_OPEN_STREAM 요청을 실행하면 미니 드라이버가 스트림 개체를 초기화합니다.
요구 사항
요구 | 값 |
---|---|
헤더 | strmini.h(Strmini.h 포함) |